Querying the Image Tag List (V3)_Image Tag Management_APIs_API Reference (Basic Edition)_SoftWare Repository for Container-Huawei Cloud

Function

List the image tags.

Calling Method

For details, see Calling APIs.

Authorization Information

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

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

swr:repo:listRepoTags

List

repo *

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
swr:repo:listRepoTags	List	repo *	-	-	-

URI

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

**Table 1** Path Parameters
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. The name contains 1 to 128 characters, starting and ending 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. If the parameter value contains a slash (/), replace it with a dollar sign ($) before sending 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.
without_accessory	No	Boolean	Whether to return the signed image.
order_column	No	String	Custom sorting key. Currently, only updated_at and tag are supported.
order_type	No	String	Sorting mode. The value can be desc or asc. This parameter must be used together with order_column.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Message body type (format). The value can be: application/json;charset=utf-8 application/json
X-Auth-Token	Yes	String	User token. You can obtain the token by calling the IAM API used to obtain a user token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
has_more	Boolean	Whether there is data on the next page during pagination query.
nextMarker	String	Start position for the next pagination query. If this parameter is not returned, the data query is complete.
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, which can be 1 or 2.
path	String	Image pull path. The format is swr.example.com/namespace/repository:tag.
internal_path	String	Image pull path within a CCE cluster, 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 an image was created. It is the UTC standard time. You 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. You 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	The value 0 indicates a manifest, and 1 indicates the manifest list.

Example Requests

None

Example Responses

Status code: 200

{
  "tags" : [ {
    "id" : 1,
    "repo_id" : 1,
    "tag" : "latest",
    "image_id" : "741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6",
    "manifest" : "",
    "digest" : "sha256:57b605845a6367c34bfb6ea6477f16852f59aa1861a2b51d10ab77ae0a1dc9c3",
    "schema" : 2,
    "path" : "swr.example.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",
  "has_more" : true
}

Status Codes

Status Code	Description
200	The list of image tags has been queried.
400	Request error.
401	Authorization failed.
403	Access denied.
404	Resource not found.
500	Internal error.

Error Codes

See Error Codes.

Querying the Image Tag List (V3)