查询镜像缓存

DescribeImageCache（查询镜像缓存）

接口描述

该接口适用于查询镜像缓存

请求方式

POST/GET

输入参数

参数	类型	是否必选	描述
DescribeImageCache	String	否	镜像缓存id
Marker	Integer	否	分页标识，单次调用未返回全部实例时，标记下次调用的返回值的起点，默认值是0
MaxResults	Integer	否	单次调用所返回的最大实例数目，默认20
Image	String	是	模糊匹配，镜像关键字，如ksyun/nginx、nginx等
ImageCacheName	String	否	模糊匹配，镜像名称关键字

返回参数

参数	类型	描述
RequestId	String	请求id
TotalCount	Integer	查询镜像缓存数目
MaxResults	Integer	单次调用返回的最大数
Marker	Integer	分页标识，如果调用未返回全部实例，标记下次调用的返回值的起点，如果已返回全部实例，则其值为0
ImageCaches	Array of ImageCaches	镜像缓存信息

ImageCaches

参数	类型	描述
ImageCacheId	String	镜像缓存id
ImageCacheName	String	镜像缓存名称
Images	List	镜像缓存包含的镜像列表
ImageCacheSize	Integer	镜像缓存大小
Status	String	镜像缓存状态，有效值： - Preparing：准备中 - Creating：创建中 - SnapshotCreating：制作快照中 - Ready：创建完成 - Failed：创建失败 注： 1.在状态为Preparing和SnapshotCreating时，不能删除镜像缓存 2.只有状态为Ready时，才能正常使用该镜像缓存
CreationTime	String	创建时间
ExpireDateTime	String	到期时间
SnapshotId	String	镜像缓存对应的快照id
ContainerGroupId	String	用于制作镜像缓存的容器实例id
Reason	String	镜像缓存制作失败的原因，如制作成功则值为空

调用示例

示例1 查询镜像缓存

输入示例

http://kci.api.ksyun.com/?Action=DescribeImageCache&Version=2020-07-02
&ImageCacheId.1=338a3364-aba4-4a4c-bcdf-f641xxxxxx

返回示例

{
    "RequestId": "338a3364-aba4-4a4c-bcdf-f6410cxxxxxx",
    "MaxResults": 20,
    "Marker": 0,
    "TotalCount": 1,
    "ImageCaches": [
        {
            "ImageCacheId": "118bdf3a-756b-4748-8fd2-545f30xxxxxx",
            "ImageCacheName": "test-cache",
            "Images": [
                "hub.kce.ksyun.com/ksyun/nginx:latest"
            ],
            "ExpireTime": "2023-07-12 22:19:07",
            "CreateTime": "2023-07-02 22:19:07",
            "Status": "Ready",
            "SnapshotId": "67522a2f-421e-4b37-b77d-799603xxxxxx",
            "ImageCacheSize": 20,
            "Reason": "",
            "ContainerGroupId": "a1fe7f94-047a-4e8a-a707-687d39xxxxxx"
        }
    ]
}