Creates a project.

Request headers

The CreateProject operation does not have operation-specific request headers and uses only common request headers. For more information, see Common request headers.

Request syntax


Request parameters

Parameter Type Position Required Example Description
Object Body Yes

The body of the request.

description String Body Yes this is test

The description of the project.

projectName String Body Yes test-project

The name of the project. The name must be unique in a region. You cannot change the name after you create the project. The name must meet the following requirements:

  • The name must be globally unique.
  • The name can contain only lowercase letters, digits, and hyphens (-).
  • The name must start and end with a lowercase letter or a digit.
  • The name must be 3 to 63 characters in length.

Response parameters

Parameter Type Example Description
Server String nginx

The name of the server.

Content-Type String application/json

The type of the response body. Valid values: application/json and application/x-protobuf.

Content-Length String 0

The length of the response body.

Connection String close

Indicates whether the connection is persistent. Valid values:

  • close: The connection is non-persistent. A new TCP connection is established for each HTTP request.
  • keep-alive: The connection is persistent. After a TCP connection is established, the connection remains open, and no more time or bandwidth is consumed to establish new connections.
Date String Sun, 27 May 2018 08:25:04 GMT

The time at which the response was returned.

x-log-requestid String 5B0A6B60BB6EE39764D458B5

The unique ID of the request. The ID is generated by Log Service.


Sample requests


  "description" : "this is test",
  "projectName" : "test-project"

Sample success responses

JSON format

HTTP/1.1 200 OK

Error codes

For a list of error codes, visit the API Error Center.







Project already exist.

The error message returned because the specified project already exists.



The body is not valid json string.

The error message returned because a specified parameter is invalid.



Specified Server Error Message.

The error message returned because an internal server error has occurred.

For more information, see Common error codes.