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.

last updated: 2024-12-11 09:32 UTC - commit: cdcd3e70988a3396f888cd75999ba6c02649623c