Creating a Project - KeystoneCreateProject

Function

This API is provided for the administrator to create a project.

The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.

Debugging

You can debug this API in API Explorer.

Authorization Information

Each account is authorized to call all APIs, but its IAM users must obtain the required permissions. For details, see Permissions and Supported Actions.

URI

POST /v3/projects

Request Parameters

**Table 1** 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	Access token issued to a user to bear its identity and permissions. For details about the permissions required by the token, see Actions.

**Table 2** Parameters in the request body
Parameter	Mandatory	Type	Description
project	Yes	Object	Project information.

**Table 3** project
Parameter	Mandatory	Type	Description
name	Yes	String	Project name, which must start with ID of an existing region_ and can contain less than or equal to 64 characters. For example, the ID of the CN-Hong Kong region is ap-southeast-1. You can create a subproject named ap-southeast-1_IAMProject in this region.
parent_id	Yes	String	Project ID of the corresponding region. For example, the project ID of the CN-Hong Kong region is 04dd42abe48026ad2fa3c01ad7fa...... For details about how to obtain the project ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.
domain_id	No	String	Account ID of the project.
description	No	String	Project description, which can contain a maximum of 255 characters.

Response Parameters

**Table 4** Parameters in the response body
Parameter	Type	Description
project	Object	Project information.

**Table 5** project
Parameter	Type	Description
is_domain	Boolean	The value is false.
description	String	Description of the project.
links	Object	Project resource link.
enabled	Boolean	Enabling status of the project.
id	String	Project ID.
parent_id	String	Project ID of the corresponding region. For example, the project ID of the CN-Hong Kong region is 04dd42abe48026ad2fa3c01ad7fa......
domain_id	String	Account ID of the project.
name	String	Project name.

**Table 6** project.links
Parameter	Type	Description
self	String	Resource link.

Example Request

Request for creating a project named ap-southeast-1_IAMProject under the account whose ID is d78cbac186b744899480f25bd0... in the CN-Hong Kong region

POST https://iam.myhuaweicloud.com/v3/projects

{
    "project": {
        "name": "ap-southeast-1_IAMProject",
        "parent_id": "aa2d97d7e62c4b7da3ffdfc11551f878",
        "domain_id": "d78cbac186b744899480f25bd0...",
        "description": "IAMDescription"
    }
}

Example Response

Status code: 201

The project is created successfully.

{
    "project": {
        "is_domain": false,
        "description": "IAMDescription",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/projects/07707ab14980265e2f5fc003a021bbc3"
        },
        "enabled": true,
        "id": "07707ab14980265e2f5fc003a021bbc3",
        "parent_id": "aa2d97d7e62c4b7da3ffdfc11551f878",
        "domain_id": "d78cbac186b744899480f25bd02...",
        "name": "ap-southeast-1_IAMProject"
    }
}