software-repository-container/api-ref/source/api/updating_image_permissions.rst

3.7 KiB

original_name

swr_02_0048.html

Updating Image Permissions

Function

Update the image operation permissions for certain users.

URI

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

For details about parameters, see Table 1 <swr_02_0048__table73271639103420>.

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 <swr_02_0048__table6912142367> Information about the image permission to be updated.
    Table 3 [Array element] parameter description
    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

    PATCH https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/access

    Body:

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

Response

  • Response parameters

    N/A

  • Example response

    {}

Status Code

Status Code Description
201 Updated successfully.
400 Request error.
401 Authentication failed.
404 The image or the image permission does not exist.
500 Internal error.