获取指定镜像的tag列表 - ListImageTag
功能介绍
获取指定镜像的tag列表。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/images/{image_id}/tags
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
eihealth_project_id | 是 | String | 参数解释: 空间ID,您可以从获取空间ID中获取。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。 默认取值: 不涉及 最小长度:1 最大长度:128 |
image_id | 是 | String | 参数解释: 镜像ID。 约束限制: 不涉及 取值范围: 仅支持字母、数字、下划线和中划线。长度应在1-128之间。 默认取值: 不涉及 最小长度:1 最大长度:128 |
project_id | 是 | String | 参数解释: 项目ID,您可以从获取项目ID中获取。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。 默认取值: 不涉及 最小长度:1 最大长度:128 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及 取值范围: 长度为[1-32768]个字符。 默认取值: 不涉及 最小长度:1 最大长度:32768 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
count | Integer | 参数解释: 镜像版本总数。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
tags | Array of GetTagDetailRsp objects | 参数解释: 镜像版本详情列表。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求示例
查询镜像版本列表。
https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/images/{image_id}/tags 响应示例
状态码:200
OK
{
"count" : 1,
"tags" : [ {
"tag" : "v1.0",
"size" : 269325517,
"create_time" : "2020-12-28T09:36:41Z",
"update_time" : "2020-12-28T09:36:41Z",
"path" : "endpoint/namespace/image-name"
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
错误码
请参见错误码。

