Updated on 2025-08-07 GMT+08:00

Querying the Image Tag List (V3)

Description

This API is used to list the image tags.

This API is only available in the following regions:

CN North-Ulanqab1, CN South-Guangzhou-InvitationOnly, CN South-Shenzhen, CN East-Qingdao, AP-Manila, TR-Istanbul, CN-Hong Kong, AP-Singapore, AP-Jakarta, CN North-Beijing1, CN North-Beijing2, CN North-Beijing4, CN East-Shanghai1, CN East-Shanghai2, CN East2, CN North-Ulanqab1, CN Southwest-Guiyang1, ME-Riyadh, CN South-Guangzhou, LA-Santiago, AP-Bangkok, LA-Sao Paulo1, LA-Mexico City1, and LA-Mexico City2

API Calling

For details, see Calling APIs.

URI

GET /v3/manage/namespaces/{namespace}/repos/{repository}/tags

Table 1 Path parameter

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending 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. Enter 1 to 128 characters. It must start and end with a lowercase letter or digit. Only lowercase letters, digits, periods (.), slashes (/), underscores (_), and hyphens (-) are allowed. Periods, slashes, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. Replace a slash (/) with a dollar sign ($) before you send the request.

Table 2 Query parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

The maximum number of image tags on each page.

The default value is 100. A maximum of 1,000 records can be returned.

marker

No

String

Marker for pagination query. The value is the nextMarker value returned in the last API calling.

tag

No

String

Image tag name, which supports fuzzy match.

with_manifest

No

Boolean

Whether to return the manifest information of the image.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Possible values:

application/json;charset=utf-8

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.

Response Parameters

Status code: 200

Table 4 Response body parameter

Parameter

Type

Description

nextMarker

String

Start position for the next pagination query. If this parameter is not returned, the data has been queried.

tags

Array of ShowRepoTagV3 objects

Image tag list.

Table 5 ShowRepoTagV3

Parameter

Type

Description

id

Integer

Tag ID.

repo_id

Integer

Repository ID.

tag

String

Image tag name.

image_id

String

Image ID.

manifest

String

Image manifest.

digest

String

Hash value of an image.

schema

Integer

Docker protocol version. The version can be 1 or 2.

path

String

External image pull address, for example, swr.cn-north-1.myhuaweicloud.com/namespace/repository:tag.

internal_path

String

Internal image pull address. For example, 10.125.0.198:20202/namespace/repository:tag.

size

Integer

Image size, ranging from 0 to 9,223,372,036,854,775,807.

is_trusted

Boolean

By default, the value is false.

created

String

Time when the image was created. It is the UTC standard time. Users need to calculate the offset based on the local time, for example, UTC+8:00 for the East 8th Time Zone.

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, UTC+8:00 for the East 8th Time Zone.

domain_id

String

Account ID.

tag_type

Integer

0: manifest; 1: manifest list

Example Request

None

Example Response

Status code: 200

The list of image tags is queried.

{
  "tags" : [ {
    "id" : 1,
    "repo_id" : 1,
    "tag" : "latest",
    "image_id" : "741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6",
    "manifest" : "",
    "digest" : "sha256:57b605845a6367c34bfb6ea6477f16852f59aa1861a2b51d10ab77ae0a1dc9c3",
    "schema" : 2,
    "path" : "swr.cn-north-1.my*****cloud.com/namespace/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",
    "domain_id" : "050*****************6d70a9600",
     "tag_type" : 0
  } ],
  "nextMarker" : "9a909b"
}

Status Codes

Status Code

Description

200

The list of image tags is queried.

400

Request error.

401

Authentication failed.

404

The image repository was not found.

500

Internal error.

Error Codes

For details, see Error Codes.