Checking the Existence of an Account Used for Image Sharing

Function

Check whether an account used for image sharing exists.

URI

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

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.

• Example request

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

Response

• Response parameters
  Status code: 200

  Table 3 Response body parameter description

  Parameter	Type	Description
  exist	Boolean	true: Exist. false: Not exist.
  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 is created. It is the UTC standard time.
  updated	String	Time when an image is updated. It is the UTC standard time.
  status	Boolean	Status. true: valid. false: expired.

• Example response

  {
      "exist": true,
      "namespace": "group",
      "repository": "busybox",
      "access_domain": "xxx",
      "permit": "read",
      "deadline": "2021-10-01T16:00:00Z",
      "description": "description",
      "creator_id": "0504186e6a8010e01f3ec009a7279baa",
      "creator_name": "xxx",
      "created": "2021-06-10T08:14:42.56632Z",
      "updated": "2021-06-10T08:14:42.566325Z",
      "status": true
  }

Status Code

Error Codes

For details, see Error Codes.