Description
Lists all of your images.
Request
GET /images?Marker={Marker}&MaxItemCount={MaxItemCount}
GET /images?Type={Type}
Request description
Name | Type | Required | Description |
Marker | String | No | Start resource ID of the current page.Default value: Null string |
MaxItemCount | int | No | Maximum number of actually returned resources. The default value is 50, and the maximum value is 100. |
Type | String | No | Returned image type. Currently, only “System” and “Self” are supported. The field is ignored if it is set to an invalid image type. The default value is “Self”. |
Response
Response status code
HTTP/1.1 200 OK
Response body
Custom image:
{
"NextMarker": "xxmarkerxx",
"Items":[
{
"CreationTime": "2016-07-18T11:53:19.110809Z",
"Description": "Image Description",
"EcsImageId": "m-32dsf3f",
"Id": "img-23jkhds",
"Name": "Usr-Image",
"OwnerId": "123456",
"Platform": "Linux",
"Type": "Self"
}
]
}
Official image:
{
"NextMarker": "xxmarkerxx",
"Items":[{
"CreationTime": "2016-10-31T06:55:33.921878Z",
"Description": "Centos 6.5 64-bit, 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-bit, 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 Enterprise Edition 64-bit Chinese",
"EcsImageId": "m-281zatqcs",
"Id": "img-windows",
"Name": "Windows-Server-2008-R2-x64",
"OwnerId": 0,
"Platform": "Windows",
"Type": "System"
}]
}
Response description
Name | Type | Description |
NextMarker | string | Start resource ID on the next page. The value is blank in the last page. |
Items | Array | Resource list. The specific resource format is described in ImageInfo. |
Error codes
Error code | Error message | HTTP status code | Meaning |
InvalidMaxItemCount | Specified parameter MaxItemCount is not valid. Its type must be integer. | 400 | MaxItemCount must be an integer. |
InvalidMaxItemCount | Specified parameter MaxItemCount is not valid. It must be in [0, 100]. | 400 | The MaxItemCount value must be in the range of [0, 100]. |