Adding Image Permissions

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

View PDF

Scenario

This section describes how to add image permissions using APIs. For details on how to call APIs, see Calling APIs.

Involved APIs

In this example, the following APIs are used:

Creating Image Permissions
Querying Image Permissions

Prerequisites

An image repository has been created. For details on how to create an image repository, see Creating an Image Repository.

Procedure

Add image permissions.
- URI format
  POST /v2/manage/namespaces/{namespace}/repos/{repository}/access
  
  For details, see Creating Image Permissions.
- Example request
  POST https://{endpoint}/v2/manage/namespaces/group/repos/test/access
  
  Body:
```
[
    {
        "user_id": "fb3f175c1fd146ab8cdae3272be*****",
        "user_name": "test",
        "auth": 7
    }
]
```
- Example response
```
{}
```

Query image permissions.

URI format
GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/access

For details, see Querying Image Permissions.
Example request
GET /v2/manage/namespaces/group/repos/test/access

Example response

{
    "id": 385550,
    "name": "test",
    "others_auths": [
        {
            "auth": 7,
            "user_id": "fb3f175c1fd146ab8cdae3272be*****",
            "user_name": "test"
        }
    ],
    "self_auth": {
        "auth": 7,
        "user_id": "fb3f175c1fd146ab8cdae3272be*****",
        "user_name": "test"
    }
}

Parent topic: Example Applications

Previous topic: Creating an Image Repository

Next topic: Adding an Image Retention Policy