Updated on 2024-04-11 GMT+08:00

Obtaining the List of Accounts Used for Image Sharing

Function

Obtain the list of accounts used for image sharing.

URI

GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name. An organization name contains 1 to 64 characters. It must start with a lowercase letter and end with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.

repository

Yes

String

Image repository name

Request

  • Request parameters
    Table 2 Request header parameters

    Parameter

    Mandatory

    Type

    Description

    Content-Type

    Yes

    String

    Message body type (format). The value can be application/json or charset=utf-8 application/json.

    The default value is application/json.

    X-Auth-Token

    Yes

    String

    User token.

    The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

  • Example request
    GET https://{Endpoint}/v2/manage/namespaces/group/repositories/busybox/access-domains

Response

  • Response parameters
    Table 3 Response body parameter description

    Parameter

    Type

    Description

    [Array element]

    Array of objects

    Shared accounts.

    Table 4 [Array element] parameter description

    Parameter

    Type

    Description

    namespace

    String

    Organization name.

    repository

    String

    Image repository name.

    access_domain

    String

    Name of the account used for image sharing.

    permit

    String

    Permission.

    deadline

    String

    Expiration time.

    description

    String

    Description.

    creator_id

    String

    Creator ID.

    creator_name

    String

    Name of the creator.

    created

    String

    Time when an image was created. It is the UTC standard time. You need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.

    updated

    String

    Time when an image was updated. It is the UTC standard time. You need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.

    status

    Boolean

    Status. true: valid; false: expired

  • Example response
    [
        {
            "namespace": "group",
            "repository": "busybox",
            "access_domain": "swr",
            "permit": "read",
            "deadline": "2021-10-01T16:00:00Z",
            "description": "description",
            "creator_id": "fb3f175c1fd146ab8cdae3272be6107b",
            "creator_name": "group",
            "created": "2021-06-10T08:14:42.56632Z",
            "updated": "2021-06-10T08:14:42.566325Z",
            "status": true
        }
    ]

Status Code

Status Code

Description

200

The list of image sharing accounts is returned successfully.

400

Request error. Error information is returned.

401

Authentication failed.

500

Internal error. Error information is returned.

Error Codes

For details, see Error Codes.