调用ListImages查询指定地域下一个或多个镜像信息。

使用说明

您可以查询指定地域下一个或多个镜像信息，包括镜像的ID、镜像名称、镜像类型等。

QPS限制

本接口的单用户QPS限制为10次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListImages

系统规定参数。取值：ListImages。

RegionId String 是 cn-hangzhou

地域ID。您可以调用ListRegions查询轻量应用服务器的可用地域。

ImageIds String 否 ["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"]

镜像ID。取值可以由一个或多个镜像ID组成一个JSON数组。格式为["xxx", "yyy", … "zzz"]。支持最多50个ID，用半角逗号字符隔开。

ImageType String 否 system

镜像类型。取值范围：

  • system：系统镜像
  • app：应用镜像
  • custom：自定义镜像

返回数据

名称 类型 示例值 描述
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

请求ID。
Images Array of Image

镜像信息组成的数组。
ImageType String app

镜像类型。可能值：

  • system：系统镜像
  • app：应用镜像
  • custom：自定义镜像
Description String WordPress是博客和内容管理网站的工具平台，借助第三方开发的模板、插件，用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。

描述信息。
ImageName String WordPress-4.8.1

镜像名称。
ImageId String 794c230fd3e64ea19f83f4d7a0ad****

镜像ID。
Platform String Linux

镜像所使用的操作系统类型。可能值：

  • Linux：Linux系统
  • Windows：Windows系统

示例

请求示例

https://swas.cn-hangzhou.aliyuncs.com/?Action=ListImages
&ImageIds=["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"]
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListImagesResponse>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
    <Images>
        <ImageType>app</ImageType>
        <Description>WordPress是博客和内容管理网站的工具平台，借助第三方开发的模板、插件，用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。</Description>
        <ImageName>WordPress-4.8.1</ImageName>
        <ImageId>794c230fd3e64ea19f83f4d7a0ad****</ImageId>
        <Platform>Linux</Platform>
    </Images>
</ListImagesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "Images" : {
    "ImageType" : "app",
    "Description" : "WordPress是博客和内容管理网站的工具平台，借助第三方开发的模板、插件，用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。",
    "ImageName" : "WordPress-4.8.1",
    "ImageId" : "794c230fd3e64ea19f83f4d7a0ad****",
    "Platform" : "Linux"
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidImageType.ValueNotSupported The specified parameter ImageType is invalid. 指定的镜像类型不合法。
403 InvalidParam The specified parameter value is invalid. 参数非法。
500 InternalError An error occurred while processing your request. 内部错误，请重试。如果多次尝试失败，请提交工单。

访问错误中心查看更多错误码。