全部產品
Search
文件中心

:擷取鏡像列表

更新時間:Jul 06, 2024

ListImages

描述

列出使用者所有鏡像資訊。

請求文法

請求行:

GET /images?Marker={Marker}&MaxItemCount={MaxItemCount}&Type={Type} HTTP/1.1

要求方法為 GET ,請求資源為 images ,屬性說明如下:

屬性名稱 類型 是否必須 描述
Marker string 本頁起始資源標識符。預設為空白字串。
MaxItemCount int 實際返回最大資源數量。預設值50,最大值100。
Type string 返回的鏡像類型,現在只支援“System”和“Self”,其他無效類型效果同無此欄位。預設:“Self”。

返回資訊

成功

狀態行:

HTTP/1.1 200 OK

響應資料:

{
    "NextMarker": "xxmarkerxx",
    "Items":[{
        "CreationTime": "2016-10-31T06:55:33.921878Z",
        "Description": "Centos 6.5 64位,python 2.6.6",
        "EcsImageId": "m-28rvocix1",
        "Id": "img-centos",
        "Name": "Centos-6.5-x64",
        "OwnerId": 0,
        "Platform": "Linux",
        "Type": "System"
    },
    {
        "CreationTime": "2016-10-31T06:55:33.921890Z",
        "Description": "Ubuntu 14.04 64位, python 2.7, jdk 1.7, Docker 1.10.1",
        "EcsImageId": "m-28lyfn0tr",
        "Id": "img-ubuntu",
        "Name": "ubuntu-14.04-x64",
        "OwnerId": 0,
        "Platform": "Linux",
        "Type": "System"
    },
    {
        "CreationTime": "2016-10-31T06:55:33.921897Z",
        "Description": "Windows Server 2008 R2 企業版 64位 中文",
        "EcsImageId": "m-281zatqcs",
        "Id": "img-windows",
        "Name": "Windows-Server-2008-R2-x64",
        "OwnerId": 0,
        "Platform": "Windows",
        "Type": "System"
    }]
}

屬性說明

屬性名稱 類型 是否必須 描述
NextMarker string 下一頁起始資源標識符。最後一頁該值為空白。
Items array 資源清單,具體的資源格式由ImageInfo描述。

錯誤

狀態代碼 錯誤碼 錯誤資訊 語義
400 InvalidMaxItemCount Specified parameter MaxItemCount is not valid. Its type must be integer. MaxItemCount必須是一個integer
400 InvalidMaxItemCount Specified parameter MaxItemCount is not valid. It must be in [0, 100]. MaxItemCount的大小必須在0與100之間