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.

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

Error Codes

For details, see Error Codes.