DescribeImageList - 查询镜像列表

查询镜像列表。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecd:DescribeImageListlist
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ImageIdstring

镜像 ID。

imgc-075cllfeuazh0****
ImageTypestring

镜像类型。

枚举值:
  • User自定义镜像
  • System系统镜像
System
ImageNamestring

镜像名称。

安卓12系统镜像
Statusstring

镜像的状态。

枚举值:
  • AVAILABLE可以
  • DELETE已删除
  • INIT初始化中
  • CREATE_FAILED创建失败
  • CREATING创建中
AVAILABLE
NextTokenstring

用来表示当前开始读取的位置。置空表示从头开始。

AAAAAV3MpHK1AP0pfERHZN5pu6kw9dGL5jves2FS9RLq****
MaxResultsinteger

分页查询时每页的最大条目数。取值范围 1~100,默认值为 20。

20

返回参数

名称类型描述示例值
object

返回参数。

NextTokenstring

用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****
Dataarray<object>

返回数据。

Dataobject

返回数据。

AliUidlong

阿里云账号 ID。

117819727354****
Descriptionstring

描述。

description
GmtCreatestring

创建时间。

2024-02-01 10:56:36
GmtModifiedstring

修改时间

2024-02-01 10:56:36
ImageIdstring

镜像 ID。

imgc-075cllfeuazh****
ImageTypestring

镜像类型。

枚举值:
  • User自定义镜像
  • System系统镜像
System
Languagestring

语言。

zh
ImageNamestring

镜像名称。

IMAGE
ImageRegionListarray

可用地域列表。

ImageRegionListstring

地域。

cn-hangzhou
Statusstring

镜像状态。

枚举值:
  • AVAILABLE可用
  • DELETE已删除
  • INIT初始化中
  • CREATE_FAILED创建失败
  • CREATING创建中
AVAILABLE
SystemTypestring

操作系统类型。

Android 12
ImageRegionDistributeMapobject

镜像分发地域信息,key 为地域,value 为分发信息。

object

分发的信息。

DistributeStatusstring

分发状态

枚举值:
  • AVAILABLE可用
  • DELETE已删除
  • INIT初始化中
  • CREATE_FAILED创建失败
  • CREATING创建中
AVAILABLE
Progressstring

分发进度。

100%
ReleaseTimestring

发布时间。

2024-07-25 10:06:45
RenderingTypestring

渲染类型。

枚举值:
  • GPURemoteGPURemote
  • CPUCPU
  • GPULocalGPULocal
CPU
TotalCountinteger

总条目数。

30
RequestIdstring

请求 ID。

620740FF-492F-5956-B1BA-361E966C0269

示例

正常返回示例

JSON格式

{
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****",
  "Data": [
    {
      "AliUid": 0,
      "Description": "description",
      "GmtCreate": "2024-02-01 10:56:36\n",
      "GmtModified": "2024-02-01 10:56:36\n",
      "ImageId": "imgc-075cllfeuazh****",
      "ImageType": "System",
      "Language": "zh",
      "ImageName": "IMAGE",
      "ImageRegionList": [
        "cn-hangzhou"
      ],
      "Status": "AVAILABLE",
      "SystemType": "Android 12",
      "ImageRegionDistributeMap": {
        "key": {
          "DistributeStatus": "AVAILABLE",
          "Progress": "100%"
        }
      },
      "ReleaseTime": "2024-07-25 10:06:45",
      "RenderingType": "CPU"
    }
  ],
  "TotalCount": 30,
  "RequestId": "620740FF-492F-5956-B1BA-361E966C0269"
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-07-24OpenAPI 返回结构发生变更查看变更详情