Querying the List of Image Repository Tags

Function

Query all image tags of an image repository.

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags?filter=offset::{offset}|limit::{limit}|order_column::{order_column}|order_type::{order_type}|tag::{tag}

For details about parameters, see Table 1.

Request

• Request parameters

  N/A

• Example request

  GET https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/tags

Response

• Response parameters

  Table 2 Response body parameter description

  Parameter	Type	Description.
  [Array element]	Array of objects	Image repository tag list.

  Table 3 [Array element] parameters description

  Parameter	Type	Description
  id	Integer	ID
  repo_id	Integer	Repository ID.
  Tag	String	Image tag name.
  image_id	String	Image ID.
  manifest	String	Image manifest.
  digest	String	SHA value of an image.
  schema	Integer	Docker protocol version. The version can be 1 or 2.
  path	String	External image pull address. The format is {Repository address}/{Namespace name}/{Repository name}:{Tag name}.
  internal_path	String	Internal image pull address. The format is {Repository address}/{Namespace name}/{Repository name}:{Tag name}.
  size	Integer	Image size. Value range: 0 to 9223372036854775807 Unit: byte
  is_trusted	Boolean	By default, the value is false.
  created	String	Time when an image is created. It is the UTC standard time. Users 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 is updated. It is the UTC standard time. Users need to calculate the offset based on the local time. For example, GMT+8 is 8 hours ahead the GMT time.
  deleted	String	Time when an image was deleted.
  domain_id	String	Account ID.
  tag_type	Integer	0: manifest. 1: manifest list.

• Example response

  [
      {
          "id": 0,
          "repo_id": 0,
          "Tag": "latest",
          "image_id": "741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6",
          "manifest": "{\"schemaVersion\":2,\"mediaType\":\"application/vnd.docker.distribution.manifest.v2+json\",\"config\":{\"mediaType\":\"application/vnd.docker.container.image.v1+json\",\"size\":1862,\"digest\":\"sha256:741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6\"},\"layers\":[{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":1292800,\"digest\":\"sha256:8ac8bfaff55af948c796026ee867448c5b5b5d9dd3549f4006d9759b25d4a893\"},{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":10240,\"digest\":\"sha256:77ddbf3a9fe11e81761a0f9df43a28e3e6f29bbb53c0c8cf71cd7efa69729aed\"}]}",
          "digest": "sha256:57b605845a6367c34bfb6ea6477f16852f59aa1861a2b51d10ab77ae0a1dc9c3",
          "schema": 2,
          "path": "{Repository address}/group/busybox:latest",
          "internal_path": "10.125.0.198:20202/namespace/busybox:latest",
          "size": 1304902,
          "is_trusted": false,
          "created": "2018-07-06T06:18:55Z",
          "updated": "2018-07-06T06:18:55Z",
          "deleted": null,
          "domain_id": "0503dda878000fed0f75c0096d70a960",
          "tag_type": 0
      }
  ]

Status Code