Listing the Signed Image Tags Associated with a Signing Image

Query the list of signed image tags associated with a signing image.

This API is available only in CN South-Shenzhen.

For details, see Calling APIs.

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.
If you are using identity policy-based authorization, the permission listed below is required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

swr:repo:listReference

List

repo *

-

-

-

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

GET /v2/manage/namespaces/{namespace}/repos/{repository}/{tag}/references

**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. Enter 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. Replace a slash (/) with a dollar sign ($) before you send the request.
sig_tag	Yes	String	Tag of the signing image. The tagType of the signing image is 2, and the tag name format is sha256-xxx.sig.

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
limit	No	Integer	Number of signed image tags on the current page. The default value is 10. A maximum of 10 records can be returned.
marker	No	String	Start marker of the pagination query. The value of next_marker returned by the API is the start marker of the next query.

**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. You can obtain the token by calling the IAM API used to obtain a user token.

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
next_marker	String	Start ID for the next pagination query. If this parameter is not returned, the data has been queried.
has_more	Boolean	Whether there is data on the next page during pagination query.
tags	Array of strings	Image tag list.

None

Status code: 200

Request succeeded.

{
  "next_marker" : "Mjk3ODcwOjA=",
  "has_more" : true,
  "tags" : [ "latest" ]
}

For details, see Error Codes.

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

For any further questions, feel free to contact us through the chatbot.