Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com> Co-authored-by: Wei, Hongmin <weihongmin1@huawei.com> Co-committed-by: Wei, Hongmin <weihongmin1@huawei.com>
12 KiB
Creating a Project
Function
This API is used to create a project.
URI
POST /v3/projects
Request Parameters
- Parameters in the request header
Parameter
Mandatory
Type
Description
Content-Type
Yes
String
Fill application/json;charset=utf8 in this field.
X-Auth-Token
Yes
String
Authenticated token with the Security Administrator permission.
- Parameters in the request body
Parameter
Mandatory
Type
Description
name
Yes
String
Project name, which must start with "ID of an existing region_" and be less than or equal to 64 characters.
Example: {region_id}_test1
parent_id
Yes
String
Parent project ID which a project belongs to.
domain_id
No
String
ID of the domain that a project belongs to.
description
No
String
Project description, which can contain a maximum of 255 characters.
- Example request
curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X POST -d '{"project":{"domain_id":"acf2ffabba974fae8f30378ffde2c...","name":"region_test1"}}' https://sample.domain.com/v3/projects
Response Parameters
Example response
{ "project": { "is_domain": false, "description": "", "links": { "self": "https://sample.domain.com/v3/projects/3de1461665f045ef91ba1efe8121b979" }, "enabled": true, "id": "3de1461665f045ef91ba1efe8121b979", "parent_id": "d1294857fdf64251994892b344f53e88", "domain_id": "d1294857fdf64251994892b344f53e88", "name": "region_test1" } }
Status Codes
Status Code |
Description |
---|---|
201 |
The request is successful. |
400 |
The server failed to process the request. |
401 |
Authentication failed. |
403 |
Access denied. |
409 |
Duplicate project name. |