Help Center/ Software Repository for Container/ API Reference/ API/ Image Tag Management/ Querying the List of Image Repository Tags
Updated on 2023-04-04 GMT+08:00

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.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

repository

Yes

String

Image repository name.

offset

No

Integer

Start index.

limit

No

Integer

Number of responses.

order_column

No

String

Sorting by column. You can set this parameter to updated_at (sorting by update time).

order_type

No

String

Sorting type. You can set this parameter to desc (descending sort) and asc (ascending sort).

tag

No

String

Image tag name.

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

Status Code

Description

200

All tags in the image repository are successfully queried.

400

Request error. Error information is returned.

401

Authentication failed.

404

The repository does not exist.

500

Internal error. Error information is returned.