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

Adding Image Permissions

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 to:

Endpoints

An endpoint is the request address for calling an API. Endpoints vary depending on services and regions. For the endpoints of SWR, see Regions and Endpoints.

Prerequisites

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

Procedure

  1. Create 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
      {}
  2. 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"
          }
      }