调用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。

返回数据

名称 类型 示例值 描述
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

镜像缓存名称。

示例

请求示例

https://eci.aliyuncs.com/?Action=DescribeImageCaches
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeImageCachesResponse>
    <RequestId>94F52CFA-F398-5326-A698-61D6316993A6</RequestId>
    <ImageCaches>
        <Status>Ready</Status>
        <ImageCacheSize>50</ImageCacheSize>
        <Progress>100%</Progress>
        <ImageCacheId>imc-2ze3z4chbqs5g17n****</ImageCacheId>
        <ResourceGroupId>rg-acfmzw2jz2z****</ResourceGroupId>
        <Images>registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2</Images>
        <SnapshotId>s-2ze49dgr09icilv5****</SnapshotId>
        <Events>
            <Type>Normal</Type>
            <LastTimestamp>2021-07-26T09:47:20Z</LastTimestamp>
            <Message>Successfully check image cache resource.</Message>
            <Count>1</Count>
            <FirstTimestamp>2021-07-26T09:47:20Z</FirstTimestamp>
            <Name>imagetest.16954e378feacd40</Name>
        </Events>
        <Events>
            <Type>Normal</Type>
            <LastTimestamp>2021-07-26T09:47:30Z</LastTimestamp>
            <Message>Successfully pulled image registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2</Message>
            <Count>1</Count>
            <FirstTimestamp>2021-07-26T09:47:30Z</FirstTimestamp>
            <Name>imagetest.16954e39c27740c0</Name>
        </Events>
        <Events>
            <Type>Normal</Type>
            <LastTimestamp>2021-07-26T09:47:51Z</LastTimestamp>
            <Message>Successfully pulled images.</Message>
            <Count>1</Count>
            <FirstTimestamp>2021-07-26T09:47:51Z</FirstTimestamp>
            <Name>imagetest.16954e3e97061740</Name>
        </Events>
        <Events>
            <Type>Normal</Type>
            <LastTimestamp>2021-07-26T09:47:51Z</LastTimestamp>
            <Message>[eci.imagecache]Total capacity utilization of current CacheDisk is 0.52GB / 50GB</Message>
            <Count>1</Count>
            <FirstTimestamp>2021-07-26T09:47:51Z</FirstTimestamp>
            <Name>imagetest.16954e3e97061740</Name>
        </Events>
        <ImageCacheName>imagetest</ImageCacheName>
        <CreationTime>2021-07-26T09:47:05Z</CreationTime>
        <ContainerGroupId>eci-2ze3z4chbqs5g17n****</ContainerGroupId>
        <RegionId>cn-beijing</RegionId>
        <ExpireDateTime/>
        <LastMatchedTime>2021-08-18T03:48:10Z</LastMatchedTime>
    </ImageCaches>
</DescribeImageCachesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "94F52CFA-F398-5326-A698-61D6316993A6",
  "ImageCaches" : [ {
    "Status" : "Ready",
    "ImageCacheSize" : 50,
    "Progress" : "100%",
    "ImageCacheId" : "imc-2ze3z4chbqs5g17n****",
    "ResourceGroupId" : "rg-acfmzw2jz2z****",
    "Images" : [ "registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2" ],
    "SnapshotId" : "s-2ze49dgr09icilv5****",
    "Events" : [ {
      "Type" : "Normal",
      "LastTimestamp" : "2021-07-26T09:47:20Z",
      "Message" : "Successfully check image cache resource.",
      "Count" : 1,
      "FirstTimestamp" : "2021-07-26T09:47:20Z",
      "Name" : "imagetest.16954e378feacd40"
    }, {
      "Type" : "Normal",
      "LastTimestamp" : "2021-07-26T09:47:30Z",
      "Message" : "Successfully pulled image registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2",
      "Count" : 1,
      "FirstTimestamp" : "2021-07-26T09:47:30Z",
      "Name" : "imagetest.16954e39c27740c0"
    }, {
      "Type" : "Normal",
      "LastTimestamp" : "2021-07-26T09:47:51Z",
      "Message" : "Successfully pulled images.",
      "Count" : 1,
      "FirstTimestamp" : "2021-07-26T09:47:51Z",
      "Name" : "imagetest.16954e3e97061740"
    }, {
      "Type" : "Normal",
      "LastTimestamp" : "2021-07-26T09:47:51Z",
      "Message" : "[eci.imagecache]Total capacity utilization of current CacheDisk is 0.52GB / 50GB",
      "Count" : 1,
      "FirstTimestamp" : "2021-07-26T09:47:51Z",
      "Name" : "imagetest.16954e3e97061740"
    } ],
    "ImageCacheName" : "imagetest",
    "CreationTime" : "2021-07-26T09:47:05Z",
    "ContainerGroupId" : "eci-2ze3z4chbqs5g17n****",
    "RegionId" : "cn-beijing",
    "ExpireDateTime" : "",
    "LastMatchedTime" : "2021-08-18T03:48:10Z",
    "Tags" : [ ]
  } ]
}

错误码

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. 操作被禁止，因为用户还未进行实名认证。

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