查询可用镜像
描述
查询用户可以使用的镜像列表。显示出的镜像资源列表包括用户自己私有的镜像,阿里云提供系统资源,其他公共的镜像资源和镜像市场的镜像,镜像市场的镜像需要先到镜像市场的网站上订阅后才能进行创建云服务器实例。此接口支持分页查询,查询结果包括可使用的镜像资源的总数和当前页的镜像资源。每页的数量默认为 10 条。
请求参数
名称 类型 是否必须 描述UnAvailable | Available | Creating | CreateFailed
默认值:AvailableCreating 创建中
Available 可用
UnAvailable 不可用
CreateFailed 创建失败
system | self | others | marketplace
默认值:无,表示返回 system + self + otherssystem 阿里云官方提供镜像
self 用户自定义镜像
others 非自己的可用镜像
marketplace 镜像市场提供的镜像
返回参数
名称 类型 描述错误码
错误代码 描述 Http 状态码 语义示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeImages
&RegionId=cn-hangzhou
&<公共请求参数>
返回示例
JSON格式
{
"Images": {
"Image": [
{
"Architecture": "x86_64",
"CreationTime": "2015-05-06T09:01:32Z",
"DiskDeviceMappings": {
"DiskDeviceMapping": [
{
"Device": "/dev/xvda",
"Size": "20"
}
]
},
"ImageId": "suse11sp3_64_20G_aliaegis_20150428.vhd",
"ImageName": "suse11sp3_64_20G_aliaegis_20150428.vhd",
"ImageOwnerAlias": "system",
"ImageVersion": "1",
"IsCopied": false,
"IsSubscribed": false,
"OSName": "SUSE Linux Enterprise Server 11 SP3 64位",
"OSType": "linux",
"Platform": "SUSE",
"Progress": "100%",
"Size": 20,
"Status": "Available",
"Usage": "instance"
}
]
}
"PageNumber": 1,
"PageSize": 1,
"RegionId": "cn-hangzhou",
"RequestId": "49CBCED4-C9B9-4851-BEB5-8FB5E5169E30",
"TotalCount": 24