All Products
Search
Document Center

ListImages

Last Updated: May 11, 2018

Description

Lists all of your images.

Request

  1. GET /images?Marker={Marker}&MaxItemCount={MaxItemCount}
  2. 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

  1. HTTP/1.1 200 OK

Response body

Custom image:

  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. }

Official image:

  1. {
  2. "NextMarker": "xxmarkerxx",
  3. "Items":[{
  4. "CreationTime": "2016-10-31T06:55:33.921878Z",
  5. "Description": "Centos 6.5 64-bit, 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-bit, 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 Enterprise Edition 64-bit Chinese",
  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. }

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].