修改一份自訂鏡像的名稱和描述。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ModifyImageAttribute
RegionId String 是 自訂鏡像所在的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ImageId String 是 自訂鏡像的 ID。
ImageName String 否 自訂鏡像名稱。
  • 能包含 [2, 128] 個英文或中文字元。
  • 必須以大小字母或中文開頭，可包含數字、半形冒號（:）、底線（_）或者連字號（-）。
  • 不能以 http:// 和 https:// 開頭。
Description String 否 自訂鏡像的描述資訊。
  • 能包含 [0, 256] 個字元。
  • 不能以 http:// 和 https:// 開頭。
  • 不填則為空，預設為空。

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ModifyImageAttribute
&ImageId=m-281234567
&RegionId=cn-qingdao
&ImageName=testImage123
&<公共請求參數>
返回樣本

XML 格式

<ModifyImageAttributeResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifyImageAttributeResponse>
JSON 格式 
{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidDescription.Malformed The specified description is wrongly formed. 400 指定的 Description 不合法。
InvalidImageName.Duplicated The specified Image name has already bean used. 400 指定的 ImageName 已經被使用。
InvalidImageName.Malformed The specified Image name is wrongly formed. 400 無效的 ImageName 取值，字元不支援或者超出長度。
MissingParameter The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 缺少必填參數 RegionId。
InvalidImageId.NotFound The specified ImageId does not exist. 403 指定的鏡像不存在。
InvalidRegionId.NotFound The specified region does not exist. 404 指定的 RegionId 不存在。