Dong, Qiu Jian f5c28c856a SWR API update 20241012

Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com>
Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>

2024-10-18 07:19:46 +00:00

11 KiB

Raw Blame History

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.

Parent topic: Organization Management

11 KiB Raw Blame History