Querying the List of Organizations

Updated on 2023-04-04 GMT+08:00

View PDF

Function

Query the list of organizations.

URI

GET /v2/manage/namespaces

**Table 1** Query parameters
Parameter	Mandatory	Type	Description
namespace	No	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.
filter	No	String	Enter *namespace::{namespace}\|mode::{mode}. {namespace}* indicates the organization name. If {mode} is not set, the list of authorized organizations is displayed. If {mode} is set to visible, the list of visible organizations is displayed. (Some organizations can be viewed by the repository, but cannot by the organization.)

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

Example response

{
    "namespaces": [
        {
            "id": 1343008,
            "name": "group",
            "creator_name": "username",
            "auth": 7
        }
    ]
}