调用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 否 registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

镜像缓存包含的镜像。
Tag.N.Key String 否 imc

镜像缓存标签键。N的取值范围为：1~20。
Tag.N.Value String 否 test

镜像标签值。N的取值范围为：1~20。
ResourceGroupId String 否 rg-2df3isufhi38****

所属资源组ID。

返回数据

名称 类型 示例值 描述
ImageCaches Array of ImageCache

镜像缓存信息列表，单次查询最多返回20条。
ContainerGroupId String eci-bp18oq3m15prd9jb****

容器组ID。
CreationTime String 2021-02-09T02:24:07Z

创建时间。
Events Array of Event

镜像缓存拉取镜像事件信息。
Count Integer 1

事件数。
FirstTimestamp String 2021-02-09T02:24:48Z

事件开始时间。
LastTimestamp String 2021-02-09T02:24:48Z

事件结束时间。
Message String Successfully check image cache resource.

事件消息。
Name String imagetest.1661f31f851a****

事件名称。
Type String Normal

事件类型。
ExpireDateTime String 2019-11-10T09:00:48Z

到期时间。
ImageCacheId String imc-bp195erqe9o2pb09****

镜像缓存ID。
ImageCacheName String imagetest

镜像缓存名称。
ImageCacheSize Integer 20

镜像缓存大小。单位：GiB。
Images List registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

镜像缓存包含的镜像列表。
Progress String 100%

进展完成度。
RegionId String cn-beijing

所属地域。
ResourceGroupId String rg-2df3isufhi38****

所属资源组ID。
SnapshotId String s-2zec5oj8e1yhxijt****

快照ID。
Status String Ready

镜像缓存状态。
Tags Array of Tag

镜像缓存的标签列表信息。
Key String imc

标签键。
Value String test

标签值。
RequestId String 39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301

请求ID，唯一标识。

示例

请求示例

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

正常返回示例

XML格式 

<DescribeImageCachesResponse>
      <RequestId>39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301</RequestId>
      <ImageCaches>
            <ImageCacheSize>20</ImageCacheSize>
            <Status>Ready</Status>
            <SnapshotId>s-2zec5oj8e1yhxijt****</SnapshotId>
            <Progress>100%</Progress>
            <ResourceGroupId>rg-2df3isufhi38****</ResourceGroupId>
            <ImageCacheId>imc-bp195erqe9o2pb09****</ImageCacheId>
            <ImageCacheName>imagetest</ImageCacheName>
            <CreationTime>2021-02-09T02:24:07Z</CreationTime>
            <ContainerGroupId>eci-bp18oq3m15prd9jb****</ContainerGroupId>
            <RegionId>cn-beijing</RegionId>
            <ExpireDateTime>2019-11-10T09:00:48Z</ExpireDateTime>
            <Events>
                  <Type>Normal</Type>
                  <LastTimestamp>2021-02-09T02:24:48Z</LastTimestamp>
                  <Message>Successfully check image cache resource.</Message>
                  <FirstTimestamp>2021-02-09T02:24:48Z</FirstTimestamp>
                  <Count>1</Count>
                  <Name>imagetest.1661f31f851a****</Name>
            </Events>
            <Tags>
                  <Value>test</Value>
                  <Key>imc</Key>
            </Tags>
            <Images>registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl</Images>
      </ImageCaches>
</DescribeImageCachesResponse>

JSON格式 

{
	"RequestId": "39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301",
	"ImageCaches": [{
		"ImageCacheSize": "20",
		"Status": "Ready",
		"SnapshotId": "s-2zec5oj8e1yhxijt****",
		"Progress": "100%",
		"ResourceGroupId": "rg-2df3isufhi38****",
		"ImageCacheId": "imc-bp195erqe9o2pb09****",
		"ImageCacheName": "imagetest",
		"CreationTime": "2021-02-09T02:24:07Z",
		"ContainerGroupId": "eci-bp18oq3m15prd9jb****",
		"RegionId": "cn-beijing",
		"ExpireDateTime": "2019-11-10T09:00:48Z",
		"Events": [{
			"Type": "Normal",
			"LastTimestamp": "2021-02-09T02:24:48Z",
			"Message": "Successfully check image cache resource.",
			"FirstTimestamp": "2021-02-09T02:24:48Z",
			"Count": "1",
			"Name": "imagetest.1661f31f851a****"
		}],
		"Tags": [{
			"Value": "test",
			"Key": "imc"
		}],
		"Images": "registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl"
	}]
}

错误码

HttpCode 错误码 错误信息 描述
400 Account.Arrearage Your account has an outstanding payment. 账号已经欠费。
400 DryRunOperation Request validation has been passed with DryRun flag set. 此次DryRun预检请求合格。
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. 操作被禁止，因为用户还未进行实名认证。
400 ServiceNotEnabled %s 该次请求所依赖的服务没有开通，请开通后再试。

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