全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询镜像缓存

最近更新时间:2023-07-06 21:49:09

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"
        }
    ]
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈