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

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 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"
}

Status Code	Description
201	Creation successful.
400	Request error.
401	Authentication failed.
409	The repository has been shared.
500	Internal error.

For details, see Error Codes.

Creating an Account Used for Image Sharing