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

Obtaining Details About an Organization

Description

Obtain details about an organization.

Constraints

None

API Calling

For details, see Calling APIs.

URI

GET /v2/manage/namespaces/{namespace}

Table 1 Path 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.

Request Parameters

Table 2 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.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

id

Integer

id

name

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.

creator_name

String

IAM username.

auth

Integer

User role. 7: admin. 3: edit. 1: view.

Example Request

GET https://{endpoint}/v2/manage/namespaces/{namespace}

Example Response

Status code: 200

Query succeeded.

{
  "id" : 1422,
  "name" : "huawei",
  "creator_name" : "liugenping",
  "auth" : 7
}

Status Codes

Status Code

Description

200

Query succeeded.

400

Request error.

401

Authentication failed.

404

The organization does not exist.

500

Internal error.

Error Codes

For details, see Error Codes.