Updated on 2024-12-02 GMT+08:00

Creating an Organization

Function

Create an organization.

URI

POST /v2/manage/namespaces

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). The value can be application/json;charset=utf-8 application/json

The default value is application/json.

X-Auth-Token

Yes

String

User token.

The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Table 2 Request body parameter

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.

Response Parameters

N/A

Example Request

POST https://{endpoint}/v2/manage/namespaces

{
  "namespace" : "group"
}

Example Response

N/A

Status Code

Status Code

Description

201

Creation successful.

400

The request is incorrect or the number of organizations exceeds the upper limit.

401

Authentication failed.

409

The resource already exists.

500

Internal error.