doc-exports/docs/swr/api-ref/swr_02_0029.html

Querying Details About an Organization

Description

Query the details about an organization.

Constraints

None

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 or charset=utf-8 application/json. Default value: 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 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 permissions. 7: manage. 3: edit. 1: read.

Example Request

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

Example Response

Status code: 200

Query succeeded.

{
  "id" : 1422,
  "name" : "demo",
  "creator_name" : "lgp",
  "auth" : 7
}

Status Codes

Status Code	Description
200	Query succeeded.
400	Request error.
401	Authentication failed.
404	Organization not found.
500	Internal error.

Error Codes

For details, see Error Codes.

Parent topic: Organization Management