Updated on 2024-04-19 GMT+08:00

Querying the Details of an Organization

Function

Query the details of an organization by its name.

URI

GET /v2/manage/namespaces/{namespace}

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

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 or 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 an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200
Table 3 Response body parameter description

Parameter

Type

Description

id

Integer

Organization ID

name

String

Organization name

creator_name

String

IAM username

auth

Integer

User permission

  • 7: Manage
  • 3: Write
  • 1: Read

Example Request

GET https://{Endpoint}/v2/manage/namespaces/group

Example Response

{
    "id": 1422,
    "name": "group",
    "creator_name": "username",
    "auth": 7
}

Status Code

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.