通过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	镜像缓存状态。可能值： Preparing：准备中 Creating：创建中 Ready：创建完成 Failed：创建失败 Updating：更新中 UpdateFailed：更新失败当状态为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.	操作被禁止，因为用户还未进行实名认证。

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