查询镜像缓存

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

查看PDF

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"
        }
    ]
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈