Updated on 2024-12-02 GMT+08:00

Querying Organization Permissions

Function

Query organization permissions.

URI

GET /v2/manage/namespaces/{namespace}/access

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name.

Request

  • 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.

  • Example request
    GET https://{Endpoint}/v2/manage/namespaces/group/access

Response

  • Response parameters
    Status code: 200
    Table 3 Response body parameters

    Parameter

    Type

    Description

    id

    Integer

    Permission ID.

    name

    String

    Organization name.

    creator_name

    String

    Organization creator.

    self_auth

    Object

    Permissions of the current user.

    others_auths

    Array of objects

    Permissions of other users.

    Table 4 self_auth parameter description

    Parameter

    Type

    Description

    user_id

    String

    User ID.

    user_name

    String

    Username.

    auth

    Integer

    User permission

    • 7: Manage
    • 3: Write
    • 1: Read
  • Example response
    {
        "id": 1334795,
        "name": "group",
        "creator_name": "user",
        "self_auth": {
            "user_id": "050b12577f00269a1fcfc01f65239697",
            "user_name": "user",
            "auth": 7
        },
        "others_auths": [
            {
                "user_id": "06d89c3b6d800f2d1f28c01f0d882285",
                "user_name": "user_01",
                "auth": 1
            },
            {
                "user_id": "050b12577f00269a1fcfc01f65239697",
                "user_name": "user",
                "auth": 7
            }
        ]
    }

Status Code

Status Code

Description

200

Request successful.

400

Request error.

401

Authentication failed.

404

The organization does not exist.

500

Internal error.

Error Codes

For details, see Error Codes.