使用ListRepoTag查询镜像Tag列表-容器镜像服务-阿里云-容器镜像服务(ACR)-阿里云帮助中心

查询镜像版本（Tag）列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cr:ListRepositoryTag

get

*Repository

acs:cr:{#regionId}:{#accountId}:repository/{#instanceid}/{#namespacename}/{#repositoryname}

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID	cri-kmsiwlxxdcva****
RepoId	string	是	仓库 ID	crr-tquyps22md8p****
PageNo	integer	否	页号	1
PageSize	integer	否	页大小，分页限制为最多 100 条记录。	30
NextToken	string	否	下一页标识。如果存在下一页，服务会返回 NextToken 值，下次请求时传入。搭配 MaxResults 参数使用。优先级高于 PageNo 和 PageSize。	*****V3MpHK1AP0pfERHZN5pu6lESTRpd5hnHNnmKOP/+w9F
MaxResults	integer	否	最大返回结果数。搭配 NextToken 参数使用。优先级高于 PageNo 和 PageSize。	30

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID	031572FA-7D8F-4C05-B790-1071E0E05DE6
Code	string	返回值	success
PageNo	integer	页号	1
IsSuccess	boolean	是否成功	true
PageSize	integer	页大小	30
TotalCount	string	总数量	1
NextToken	string	下一页标识。如果存在下一页，服务会返回 NextToken 值，下次请求时传入。	*****V3MpHK1AP0pfERHZN5pu6lESTRpd5hnHNnmKOP/+w9F
MaxResults	integer	最大返回结果数。	30
Images	array<object>	镜像列表
	object
Status	string	状态	NORMAL
ImageSize	integer	镜像大小，单位 Byte	27107966
ImageCreate	string	镜像创建时间	1572839125000
Digest	string	digest 值	67bfbcc12b67936ec7f867927817cbb071832b873dbcaed312a1930ba5f1****
ImageUpdate	string	镜像更新时间	1572875608000
Tag	string	镜像 TAG	v0.1
ImageId	string	镜像 ID	45023655bf39c382e26a8607d057c27871dee163c1ecf48cc1ebf2a1****

示例

正常返回示例

JSON格式

{
  "RequestId": "031572FA-7D8F-4C05-B790-1071E0E05DE6",
  "Code": "success",
  "PageNo": 1,
  "IsSuccess": true,
  "PageSize": 30,
  "TotalCount": "1",
  "NextToken": "*****V3MpHK1AP0pfERHZN5pu6lESTRpd5hnHNnmKOP/+w9F",
  "MaxResults": 30,
  "Images": [
    {
      "Status": "NORMAL",
      "ImageSize": 27107966,
      "ImageCreate": "1572839125000",
      "Digest": "67bfbcc12b67936ec7f867927817cbb071832b873dbcaed312a1930ba5f1****",
      "ImageUpdate": "1572875608000",
      "Tag": "v0.1",
      "ImageId": "45023655bf39c382e26a8607d057c27871dee163c1ecf48cc1ebf2a1****"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
500	SystemError	Unknown error.
403	NoPrivilege	Access denied for this user.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。