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

Querying Image Permissions

Function

Query image permissions.

URI

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

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

repository

Yes

String

Image name

Request

  • Request parameters

    N/A

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

Response

  • Response parameters
    Table 2 Response body parameter description

    Parameter

    Type

    Description

    id

    Integer

    Permission ID.

    name

    String

    Image name.

    self_auth

    Object

    Permissions of the current user.

    others_auths

    Array of objects

    Permissions of other users.

    Table 3 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
    Table 4 others_auths 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": 1422,
        "name": "busybox",
        "self_auth": {
            "user_id": "3059e6b5562241fda3fa441cca6f228b",
            "user_name": "admin",
            "auth": 7
        },
        "others_auths": [
            {
                "user_id": "fb3f175c1fd146ab8cdae3272be6107b",
                "user_name": "user",
                "auth": 1
            }
        ]
    }

Status Code

Status Code

Description

200

Query succeeded.

400

Request error.

401

Authentication failed.

404

The image or the image permission does not exist.

500

Internal error.