forked from docs/software-repository-container

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

5.3 KiB

Raw Permalink Blame History

original_name: swr_02_0049.html

Querying Image Permissions

Function

Query image permissions.

URI

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

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

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
namespace	Yes	String	Organization name
repository	Yes	String	Image name

Request

Request parameters

N/A

Example request

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

Response

Response parameters

**Table 2** Response body parameter description
Parameter	Type	Description
id	Integer	Permission ID.
name	String	Image name.
self_auth	`Object <swr_02_0049__table16690123312516>`	Permissions of the current user.
others_auths	Array of `objects <swr_02_0049__table2060620585538>`	Permissions of other users.

**Table 3** self_auth parameter description
Parameter	Type	Description
user_id	String	User ID
user_name	String	Username
auth	Integer	User permission 7: Manage 3: Write 1: Read

**Table 4** others_auths parameter description
Parameter	Type	Description
user_id	String	User ID
user_name	String	Username
auth	Integer	User permission 7: Manage 3: Write 1: Read

Example response

{
    "id": 1422,
    "name": "busybox",
    "self_auth": {
        "user_id": "3059e6b5562241fda3fa441cca6f228b",
        "user_name": "admin",
        "auth": 7
    },
    "others_auths": [
        {
            "user_id": "fb3f175c1fd146ab8cdae3272be6107b",
            "user_name": "user",
            "auth": 1
        }
    ]
}

Status Code

Status Code	Description
200	Query succeeded.
400	Request error.
401	Authentication failed.
404	The image or the image permission does not exist.
500	Internal error.

5.3 KiB Raw Permalink Blame History