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

Creating an Account Used for Image Sharing

Function

Create an account used for image sharing. You can share your private images with other users, granting them permissions to pull the images.

URI

POST /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.

    Table 3 Request body parameter description

    Parameter

    Mandatory

    Type

    Description

    access_domain

    Yes

    String

    Name of the account used for image sharing.

    permit

    Yes

    String

    Currently, only the read permission is supported.

    deadline

    Yes

    String

    Valid until (UTC). If the sharing is permanent, the value is forever. Otherwise, the sharing is valid until 00:00:00 of the next day.

    description

    No

    String

    Description.

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

    Body:

    {
        "access_domain": "domain_name",
        "permit": "read",
        "deadline": "2021-10-01T16:00:00.000Z",
        "description": "description"
    }

Response

  • Response parameters

    N/A

  • Example response

    None

Status Code

Status Code

Description

201

Creation successful.

400

Request error.

401

Authentication failed.

409

The repository has been shared.

500

Internal error.

Error Codes

For details, see Error Codes.