阿里云如何使用镜像相关接口(3)

修改镜像属性

描述

可以修改自定义镜像的名称和描述

请求参数

名称 类型 是否必须 描述 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"

}

所属专题:

如果您觉得本文或图片不错，请把它分享给您的朋友吧！