Querying the Image Tag List (V3)

Description

This API is used to list the image tags.

API Calling

For details, see Calling APIs.

Authorization Information

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.

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 through the IAM API used to obtain a user token. 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.{region}.my*****cloud.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 was 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.***.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"
}