software-repository-container/api-ref/source/api/creating_image_permissions.rst
proposalbot 4894df0e64 Changes to swr_api-ref from docs/doc-exports#415 (SWR API initial version reuplo
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: proposalbot <proposalbot@otc-service.com>
Co-committed-by: proposalbot <proposalbot@otc-service.com>
2022-11-10 10:13:15 +00:00

3.5 KiB

original_name

swr_02_0046.html

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 <swr_02_0046__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_0046__table6912142367> 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.