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

调试

您可以在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:自定义镜像

返回数据

名称 类型 示例值 描述
Images Array of Image

镜像信息组成的数组。

Description String WordPress是最流行的、最强大的博客和内容管理网站的工具平台,借助第三方开发的模板、插件,用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。

描述信息。

ImageId String 794c230fd3e64ea19f83f4d7a0ad****

镜像ID。

ImageName String WordPress-4.8.1

镜像名称。

ImageType String app

镜像类型。可能值:

  • system:系统镜像
  • app:应用镜像
  • custom:自定义镜像
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

请求ID。

示例

请求示例

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

正常返回示例

XML格式

<ListImagesResponse>
      <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
      <Images>
            <ImageName>WordPress-4.8.1</ImageName>
            <Description>WordPress是最流行的、最强大的博客和内容管理网站的工具平台,借助第三方开发的模板、插件,用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。</Description>
            <ImageId>794c230fd3e64ea19f83f4d7a0ad****</ImageId>
            <ImageType>app</ImageType>
      </Images>
      <Images>
            <ImageName>CentOS-7.3</ImageName>
            <Description>CentOS 是一个基于Red Hat Linux 提供的可自由使用源代码的企业级Linux发行版本</Description>
            <ImageId>fe9c66133a9d4688872869726b52****</ImageId>
            <ImageType>system</ImageType>
      </Images>
</ListImagesResponse>

JSON格式

{
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "Images": [
    {
      "ImageName": "WordPress-4.8.1",
      "Description": "WordPress是最流行的、最强大的博客和内容管理网站的工具平台,借助第三方开发的模板、插件,用户可实现多样化的个性化功能。该镜像基于CentOS 7.3 64位操作系统。",
      "ImageId": "794c230fd3e64ea19f83f4d7a0ad****",
      "ImageType": "app"
    },
    {
      "ImageName": "CentOS-7.3",
      "Description": "CentOS 是一个基于Red Hat Linux 提供的可自由使用源代码的企业级Linux发行版本",
      "ImageId": "fe9c66133a9d4688872869726b52****",
      "ImageType": "system"
    }
  ]
}

错误码

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

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