查询镜像列表

DescribeImages（查询镜像列表）

接口描述

该接口适用于在容器镜像服务实例中查询镜像列表

请求方式

GET/POST

输入参数

参数	类型	是否必选	描述
InstanceId	String	是	实例id
Namespace	String	是	命名空间名称
RepoName	String	是	镜像仓库名称
ImageId	String	否	镜像id，若不输入，则默认查询所选镜像仓库下所有镜像
MaxResults	Integer	否	单次调用所返回的最大实例数目，默认20，最大99
Marker	Integer	否	分页标识，单次调用未返回全部实例时，标记下次调用的返回值的起点，默认值是0

返回参数

参数	类型	描述
RequestId	String	任务请求id
MaxResults	Integer	单次调用所返回的最大实例数目
Marker	Integer	分页标识，单次调用未返回全部实例时，标记下次调用的返回值的起点，默认值是0
TotalCount	Integer	镜像数量
ImageSet	Array of Image	镜像列表

Image

参数	类型	描述
ImageId	String	镜像ID
Size	Integer	镜像大小，单位为字节
CreateTime	String	创建时间
TagNames	List of String	镜像版本（Tag）名称

调用示例

在容器镜像服务实例中查询镜像列表

输入示例

http://kcrs.api.ksyun.com?Action=DescribeImages&Version=2021-11-09
&InstanceId=eb1d0d73-4845-4283-a736-xxxxxx
&Namespace=ns1
&RepoName=repo2

返回示例

{
    "RequestId": "0d04b25d-6956-44fc-8066-xxxxxx",
    "MaxResults": 20,
    "Marker": 0,
    "TotalCount": 1,
    "ImageSet": [
        {
            "ImageId": "sha256:xxxxxx",
            "Size": xxxxxx,
            "CreateTime": "2022-06-27 12:03:37",
            "TagNames": [
                "v1"
            ]
        }
    ]
}