Query Image List

Last Updated：2021-11-12

This API is used to query all image information of users.
The queried image information includes system image, custom image and service integration image.
It supports the filter query by imageType. This parameter is not required, and it is all by default, i.e., query all types of images.
It supports querying a self-defined image by imageName, with a returned name containing the string Image Name. This parameter is not required. When setting ImageName, ImageType must be set’Custom’as well.

Request Structure

GET /v{version}/image?marker={marker}&maxKeys={maxKeys}&imageType={imageType}&imageName={imageName} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
…

Request header field

No other special header fields are available, except for common header fields.

Request Parameter

Parameter name	Type	Required?	Parameter Position	Description
version	String	Yes	URL Parameter	API version number
marker	String	No	Query parameters	The start position of querying the list in batches, which is a string generated by the system.
maxKeys	int	No	Query parameters	It is the maximum number contained in each page, which usually does not exceed 1,000. The default value is 1000.
imageType	String	No	Query parameters	It specifies what type of image to query, including All, System (system image/public image), Custom (custom image), Integration (service integration image), Sharing (shared image), GpuBccSystem (GPU dedicated public image), GpuBccCustom (GPU dedicated custom image), FpgaBccSystem (FPGA dedicated public image) and FpgaBccCustom (FPGA dedicated custom image), and the default value is All.
imageName	String	No	Query parameters	With filter, query custom image while setting ImageType as“Custom”

Return a header field

Other special header fields are not available, except for common header fields.

Return a parameter

Parameter Name	Type	Description
marker	String	Mark the starting position of the query
isTruncated	boolean	True means there is still data behind, and false means it is already the last page.
nextMarker	String	Gets the “marker” value to be passed on the next page. This field does not appear when “isTruncated” is “false”.
maxKeys	int	Maximum number of master instances per page
images	List<[ImageModel](#BCC/API Referance/Appendix.md#ImageModel)>	Image list returned

Request Instance

GET /v2/image?marker=m-nky7qeom&maxKeys=1 HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

Return Example

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
    "maxKeys":1,
    "marker":"m-nky7qeom",
    "isTruncated":true,
    "nextMarker":"m-I88RTNWG",
    "images":[
		{
		    "id": "m-nky7qeom",
		    "createTime": "2015-06-17T10:37:02Z",
		    "name": "ubuntu-14.04.1-server-amd64-201506171832",
		    "type": "System",
		    "osType": "linux",
		    "osVersion": "14.04.1 LTS",
		    "osName": "Ubuntu",
		    "osBuild": "2015061700",
		    "osArch": "x86_64 (64bit)",
		    "status": "Available",
		    "desc": null
		}
    ]
}

Query the List of Snapshot Chains

Automatic Snapshot Policy Related Interface

百度智能云

Cloud Compute Service

Query Image List