Querying Image Permissions

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

View PDF

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
        }
    ]
}