Querying the List of Organizations¶

Function¶

Query the list of organizations.

URI¶

GET /v2/manage/namespaces?filter=namespace::{namespace}

For details about parameters, see Table 1.

**Table 1** Parameter description¶
Parameter	Mandatory	Type	Description
namespace	No	String	Organization name

Request¶

Request parameters
N/A

Example request

GET https://{Endpoint}/v2/manage/namespaces?filter=namespace::group

Response¶

Response parameters
Table 2 Response body parameter description¶
Parameter
Type
Description
namespaces
Array of objects
Organization list
Table 3 namespaces 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

**Table 2** Response body parameter description¶
Parameter	Type	Description
namespaces	Array of objects	Organization list

**Table 3** namespaces 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 response

{
    "namespaces": [
        {
            "id": 1343008,
            "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.

last updated: 2024-05-19 02:39