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

Creating Image Permissions

Function

Grant permissions of an image to certain users so that they can manage, edit, and read the image.

URI

POST /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
    Table 2 Request body parameter description

    Parameter

    Mandatory

    Type

    Description.

    [Array element]

    Yes

    Array of objects

    User list

    Table 3 [Array element] parameters decription

    Parameter

    Mandatory

    Type

    Description

    user_id

    Yes

    String

    User ID.

    user_name

    Yes

    String

    Username.

    auth

    Yes

    Integer

    User permission that is configured.

    • 7: Manage
    • 3: Write
    • 1: Read
  • Example request
    POST https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/access

    Body:

    [
        {
            "user_id": "fb3f175c1fd146ab8cdae3272be6107b",
            "user_name": "user01",
            "auth": 1
        }
    ]

Response

  • Response parameters

    N/A

  • Example response
    {}

Status Code

Status Code

Description

201

Creation successful.

400

Request error.

401

Authentication failed.

404

The image does not exist.

500

Internal error.