修改镜像属性
描述
可以修改自定义镜像的名称和描述
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数，取值：ModifyImageAttribute
RegionId
String
是
自定义镜像的 RegionId
ImageId
String
是
自定义镜像的 ID
ImageName
String
否
自定义镜像名称，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”。不能以 // 和 https:// 开头。
Description
String
否
自定义镜像的描述信息，长度限制在 0 ~ 256 个字符，不填则为空，默认为空。不能以 // 和 https:// 开头。
返回参数
全是公共返回参数，详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
MissingParameter
An input parameter "RegionId" that is mandatory for processing the request is not supplied.
400
缺少 RegionId 值
MissingParameter
An input parameter "ImageId" that is mandatory for processing the request is not supplied.
400
缺少 ImageId 的值
InvalidImageId.NotFound
The image does not exist.
403
指定的镜像 Id 不存在
InvalidImageName.Malformed
The specified destination Image name is wrongly formed.
400
指定的镜像名称不合法
InvalidDescription.Malformed
The specified destination image description is wrongly formed.
400
指定的镜像描述不合法
InvalidImageName.Duplicated
The destination image is exist.
400
镜像名称已经重复
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyImageAttribute
&ImageId=m-281234567
&RegionId=cn-qingdao
&ImageName=testImage123
&<公共请求参数>
返回示例
XML格式
【点击图片进入下一页或下一篇】
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
删除自定义镜像
描述
删除指定的用户自定义镜像。镜像删除之后将不能再用于创建、重置ECS实例。
如果指定的镜像不存在，则请求将被忽略.
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数，取值：DeleteImage
RegionId
String
是
镜像所在的 Region ID
ImageId
String
是
镜像 ID
返回参数
全是公共返回参数，详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
MissingParameter
The input parameter "RegionId" that is mandatory for processing this request is not supplied.
400
缺少 RegionId 字段
MissingParameter
The input parameter "ImageId" that is mandatory for processing this request is not supplied.
400
缺少的 ImageId 字段
InvalidRegionId.NotFound
The specified region does not exist.
404
无效的 Region 取值（实际情况也可能是该用户无权使用此 Region）
ImageUsingByInstance
The specified image has been used to create instance(s).
403
指定的镜像 Id 还存在保有实例，不能删除该镜像
示例
请求示例
https://ecs.aliyuncs.com/?Action=DeleteImage
&RegionId=cn-hangzhou
&ImageId=m-63DFD5FB2
&<公共请求参数>
返回示例
XML格式
【点击图片进入下一页或下一篇】
JSON格式
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
所属专题:
