All Products
Search
Document Center

Batch Compute:ListImages

Last Updated:Feb 24, 2023

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

Note

Response status code

HTTP/1.1 200 OK
Note

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