Queries information about image caches.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeImageCaches

The operation that you want to perform. Set the value to DescribeImageCaches.

RegionId String Yes cn-hangzhou

The region ID of the image cache.

ImageCacheId String No imc-bp195erqe9o2pb09****

The ID of the image cache.

ImageCacheName String No testcache

The name of the image cache.

SnapshotId String No s-2zec5oj8e1yhxijt****

The ID of the image cache snapshot.

ResourceGroupId String No rg-2df3isufhi38****

The ID of the resource group.

Tag.N.Key String No imc

The key of tag N of the image cache. Valid values of N: 1 to 20.

Tag.N.Value String No test

The tag value that you want to add to the image cache. Valid values of N: 1 to 20.

MatchImage.N RepeatList No registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

Specifies the image N on which the image cache query is based. Valid values of N: 1 to 100.

Response parameters

Parameter Type Example Description
ImageCaches Array of ImageCache

The image caches.

ContainerGroupId String eci-bp18oq3m15prd9jb****

The ID of the container group.

CreationTime String 2021-02-09T02:24:07Z

The time when the image cache was created.

Events Array of Event

Details about the events of pulling images to create the image cache.

Count Integer 1

The number of events.

FirstTimestamp String 2021-02-09T02:24:48Z

The time when the event started.

LastTimestamp String 2021-02-09T02:24:48Z

The time when the event ended.

Message String Successfully check image cache resource.

The message of the event.

Name String imagetest.1661f31f851a****

The name of the event.

Type String Normal

The type of the event.

ExpireDateTime String 2019-11-10T09:00:48Z

The time when the image cache expires.

FlashSnapshotId String s-bp12w3v37sit96t6****

The ID of the local snapshot. A temporary local snapshot is created after the instant image cache feature is enabled.

ImageCacheId String imc-bp195erqe9o2pb09****

The ID of the image cache.

ImageCacheName String imagetest

The name of the image cache.

ImageCacheSize Integer 20

The size of the image cache. Unit: GiB.

Images List registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

The images that are contained in the image cache.

LastMatchedTime String 2021-08-18T03:48:10Z

The time when the image cache was last matched.

Progress String 100%

The progress of creating the image cache snapshot.

Note After the instant image cache feature is enabled, the system creates a temporary local snapshot and then a normal snapshot. This parameter indicates the progress of creating the normal snapshot.
RegionId String cn-beijing

The region ID of the image cache.

ResourceGroupId String rg-2df3isufhi38****

The ID of the resource group.

SnapshotId String s-2zec5oj8e1yhxijt****

The ID of the image cache snapshot.

Status String Ready

The state of the image cache. Valid values:

  • Preparing: The image cache is being prepared.
  • Creating: The image cache is being created.
  • Ready: The image cache is created.
  • Failed: The image cache failed to be created.
  • Updating: The image cache is being updated.
  • UpdateFailed: The image cache failed to be updated.

You can use an image cache that is in the Ready state.

Tags Array of Tag

The tags of the image cache.

Key String imc

The tag key of the image cache.

Value String test

The tag value of the image cache.

RequestId String 39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301

The ID of the request.

Examples

Sample requests

https://eci.aliyuncs.com/?Action=DescribeImageCaches
&RegionId=cn-hangzhou
&<Common request parameters>|

Sample success responses

XML format 

<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></ExpireDateTime>
            <LastMatchedTime>2021-08-18T03:48:10Z</LastMatchedTime>
      </ImageCaches>
</DescribeImageCachesResponse>

JSON format 

{
    "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": []
        }
    ]
}

Error codes

HttpCode Error code Error message Description
400 Account.Arrearage Your account has an outstanding payment. The error message returned because you have an overdue payment in your account.
400 DryRunOperation Request validation has been passed with DryRun flag set. The error message returned because the request is determined as valid in the dry run.
400 ServiceNotEnabled %s The error message returned because the service that is required to call the operation is not activated. Activate the service and try again.
403 Forbidden.SubUser The specified action is not available for you. The error message returned because you do not have the permissions to perform the operation.
403 Forbidden.UserBussinessStatus This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. The error message returned because you have an overdue payment. Settle the overdue payment and try again.
403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. The error message returned because you have not completed real-name verification. The operation is not allowed.

For a list of error codes, visit the API Error Center.