通过DescribeImageCaches批量查询镜像缓存信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeImageCaches |
系统规定参数。取值:DescribeImageCaches。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
ImageCacheId | String | 否 | imc-bp195erqe9o2pb09**** |
镜像缓存ID。 |
ImageCacheName | String | 否 | testcache |
镜像缓存名称。 |
SnapshotId | String | 否 | s-2zec5oj8e1yhxijt**** |
镜像缓存对应的快照ID。 |
Image | String | 否 | nginx |
容器镜像。 |
ResourceGroupId | String | 否 | rg-2df3isufhi38**** |
所属资源组ID。 |
Tag.N.Key | String | 否 | imc |
镜像缓存标签键。N的取值范围为1~20。 |
Tag.N.Value | String | 否 | test |
镜像缓存标签值。N的取值范围为1~20。 |
MatchImage.N | String | 否 | registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl |
指定镜像,用于查询最佳匹配的镜像缓存。N的取值范围为1~100。 |
Limit | Integer | 否 | 20 |
查询结果条数上限。 |
NextToken | String | 否 | AAAAAdDWBF2**** |
查询凭证(Token),取值为上一次API调用返回的NextToken参数值。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301 |
请求ID,唯一标识。 |
ImageCaches | Array of ImageCache |
镜像缓存信息列表。 |
|
Images | Array of String | registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl |
镜像缓存包含的镜像列表。 |
CreationTime | String | 2021-02-09T02:24:07Z |
创建时间。 |
Status | String | Ready |
镜像缓存状态。可能值:
当状态为Ready时,即可使用该镜像缓存。 |
Progress | String | 100% |
镜像缓存对应快照的创建进度。 说明 如果开启了极速镜像缓存功能,将先创建一份临时使用的本地快照再创建一份普通快照,该进度为普通快照的创建进度。
|
ExpireDateTime | String | 2019-11-10T09:00:48Z |
到期时间。 |
LastMatchedTime | String | 2021-08-18T03:48:10Z |
最新一次匹配到镜像缓存的时间。 |
ContainerGroupId | String | eci-bp18oq3m15prd9jb**** |
容器组ID。 |
Tags | Array of Tag |
镜像缓存的标签列表信息。 |
|
Key | String | imc |
标签键。 |
Value | String | test |
标签值。 |
Events | Array of Event |
镜像缓存拉取镜像事件信息。 |
|
Type | String | Normal |
事件类型。 |
LastTimestamp | String | 2021-02-09T02:24:48Z |
事件结束时间。 |
Message | String | Successfully check image cache resource. |
事件消息。 |
Name | String | imagetest.1661f31f851a**** |
事件名称。 |
Count | Integer | 1 |
事件数。 |
FirstTimestamp | String | 2021-02-09T02:24:48Z |
事件开始时间。 |
ImageCacheId | String | imc-bp195erqe9o2pb09**** |
镜像缓存ID。 |
RegionId | String | cn-beijing |
所属地域。 |
SnapshotId | String | s-2zec5oj8e1yhxijt**** |
镜像缓存对应的快照ID。 |
FlashSnapshotId | String | s-bp12w3v37sit96t6**** |
本地快照ID。开启极速镜像缓存功能后,将临时创建一份本地快照。 |
ResourceGroupId | String | rg-2df3isufhi38**** |
所属资源组ID。 |
ImageCacheSize | Integer | 20 |
镜像缓存大小。单位:GiB。 |
ImageCacheName | String | imagetest |
镜像缓存名称。 |
EliminationStrategy | String | LRU |
镜像缓存的淘汰策略。默认为空,表示一直保留。 支持配置为LRU,表示可以被自动删除。当镜像缓存数量达到配额限制时,系统将自动删除最不常用的EliminationStrategy为LRU的镜像缓存。 |
NextToken | String | AAAAAdDWBF2**** |
本次调用返回的查询凭证值。 |
TotalCount | Integer | 15 |
查询结果总条数。 |
示例
请求示例
https://eci.aliyuncs.com/?Action=DescribeImageCaches
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeImageCachesResponse>
<RequestId>39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301</RequestId>
<ImageCaches>
<Images>registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl</Images>
<CreationTime>2021-02-09T02:24:07Z</CreationTime>
<Status>Ready</Status>
<Progress>100%</Progress>
<ExpireDateTime>2019-11-10T09:00:48Z</ExpireDateTime>
<LastMatchedTime>2021-08-18T03:48:10Z</LastMatchedTime>
<ContainerGroupId>eci-bp18oq3m15prd9jb****</ContainerGroupId>
<Tags>
<Key>imc</Key>
<Value>test</Value>
</Tags>
<Events>
<Type>Normal</Type>
<LastTimestamp>2021-02-09T02:24:48Z</LastTimestamp>
<Message>Successfully check image cache resource.</Message>
<Name>imagetest.1661f31f851a****</Name>
<Count>1</Count>
<FirstTimestamp>2021-02-09T02:24:48Z</FirstTimestamp>
</Events>
<ImageCacheId>imc-bp195erqe9o2pb09****</ImageCacheId>
<RegionId>cn-beijing</RegionId>
<SnapshotId>s-2zec5oj8e1yhxijt****</SnapshotId>
<FlashSnapshotId>s-bp12w3v37sit96t6****</FlashSnapshotId>
<ResourceGroupId>rg-2df3isufhi38****</ResourceGroupId>
<ImageCacheSize>20</ImageCacheSize>
<ImageCacheName>imagetest</ImageCacheName>
<EliminationStrategy>LRU</EliminationStrategy>
</ImageCaches>
<NextToken>AAAAAdDWBF2****</NextToken>
<TotalCount>15</TotalCount>
</DescribeImageCachesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301",
"ImageCaches" : [ {
"Images" : [ "registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl" ],
"CreationTime" : "2021-02-09T02:24:07Z",
"Status" : "Ready",
"Progress" : "100%",
"ExpireDateTime" : "2019-11-10T09:00:48Z",
"LastMatchedTime" : "2021-08-18T03:48:10Z",
"ContainerGroupId" : "eci-bp18oq3m15prd9jb****",
"Tags" : [ {
"Key" : "imc",
"Value" : "test"
} ],
"Events" : [ {
"Type" : "Normal",
"LastTimestamp" : "2021-02-09T02:24:48Z",
"Message" : "Successfully check image cache resource.",
"Name" : "imagetest.1661f31f851a****",
"Count" : 1,
"FirstTimestamp" : "2021-02-09T02:24:48Z"
} ],
"ImageCacheId" : "imc-bp195erqe9o2pb09****",
"RegionId" : "cn-beijing",
"SnapshotId" : "s-2zec5oj8e1yhxijt****",
"FlashSnapshotId" : "s-bp12w3v37sit96t6****",
"ResourceGroupId" : "rg-2df3isufhi38****",
"ImageCacheSize" : 20,
"ImageCacheName" : "imagetest",
"EliminationStrategy" : "LRU"
} ],
"NextToken" : "AAAAAdDWBF2****",
"TotalCount" : 15
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Account.Arrearage | Your account has an outstanding payment. | 账号已经欠费。 |
400 | DryRunOperation | Request validation has been passed with DryRun flag set. | 此次DryRun预检请求合格。 |
400 | ServiceNotEnabled | %s | 该次请求所依赖的服务没有开通,请开通后再试。 |
403 | Forbidden.SubUser | The specified action is not available for you. | 当前用户无法执行该操作 |
403 | Forbidden.UserBussinessStatus | This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. | 用户处于欠费状态不允许创建,请充值后再尝试。 |
403 | Forbidden.UserNotRealNameAuthentication | This operation is not allowed, because you have not passed the real-name verification. | 操作被禁止,因为用户还未进行实名认证。 |
访问错误中心查看更多错误码。