全部产品
Search

搜索本产品

    批量计算：获取镜像列表

    文档中心

    批量计算：获取镜像列表

    更新时间：Apr 12, 2018

    描述

    列出您的所有镜像信息（ListImages）。

    请求语法

    1. GET /images?Marker={Marker}&MaxItemCount={MaxItemCount}
    3. GET /images?Type={Type}

    请求说明

    名称 类型 是否必需 描述
    Marker string 否 本页起始资源标识符。默认为空字符串。
    MaxItemCount int 否 实际返回最大资源数量。取值范围：[0, 100]。默认值：50。
    Type string 否 返回的镜像类型。取值范围：System | Self，其他无效类型效果同无此字段。默认值：Self。

    返回信息

    返回状态码（Response Status）

    1. HTTP/1.1 200 OK

    返回体（Response Body）

    自定义镜像返回：

    1. {
    2.     "NextMarker": "xxmarkerxx",
    3.     "Items":[
    4.         {
    5.             "CreationTime": "2016-07-18T11:53:19.110809Z",
    6.             "Description": "Image Description",
    7.             "EcsImageId": "m-32dsf3f",
    8.             "Id": "img-23jkhds",
    9.             "Name": "Usr-Image",
    10.             "OwnerId": "123456",
    11.             "Platform": "Linux",
    12.             "Type": "Self"
    13.         }
    14.     ]
    15. }

    系统镜像返回：

    1. {
    2.     "NextMarker": "xxmarkerxx",
    3.     "Items":[{
    4.         "CreationTime": "2016-10-31T06:55:33.921878Z",
    5.         "Description": "Centos 6.5 64位，python 2.6.6",
    6.         "EcsImageId": "m-28rvocix1",
    7.         "Id": "img-centos",
    8.         "Name": "Centos-6.5-x64",
    9.         "OwnerId": 0,
    10.         "Platform": "Linux",
    11.         "Type": "System"
    12.     },
    13.     {
    14.         "CreationTime": "2016-10-31T06:55:33.921890Z",
    15.         "Description": "Ubuntu 14.04 64位, python 2.7, jdk 1.7, Docker 1.10.1",
    16.         "EcsImageId": "m-28lyfn0tr",
    17.         "Id": "img-ubuntu",
    18.         "Name": "ubuntu-14.04-x64",
    19.         "OwnerId": 0,
    20.         "Platform": "Linux",
    21.         "Type": "System"
    22.     },
    23.     {
    24.         "CreationTime": "2016-10-31T06:55:33.921897Z",
    25.         "Description": "Windows Server 2008 R2 企业版 64位 中文",
    26.         "EcsImageId": "m-281zatqcs",
    27.         "Id": "img-windows",
    28.         "Name": "Windows-Server-2008-R2-x64",
    29.         "OwnerId": 0,
    30.         "Platform": "Windows",
    31.         "Type": "System"
    32.     }]
    33. }

    返回说明

    名称 类型 是否必需 描述
    NextMarker string 是 下一页起始资源标识符。最后一页该值为空。
    Items array 是 资源列表，具体的资源格式由 ImageInfo 描述。

    错误码

    错误代码 错误信息 HTTP 状态码 说明
    InvalidMaxItemCount Specified parameter MaxItemCount is not valid. Its type must be integer. 400 MaxItemCount 的数据类型必须是 Integer。
    InvalidMaxItemCount Specified parameter MaxItemCount is not valid. It must be in [0, 100]. 400 MaxItemCount 不能超过 100。