ModifyImageAttribute

Last Updated: May 22, 2018

Description

Modifies the name and description of a custom image.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: ModifyImageAttribute.
RegionId String Yes RegionId of the custom image. For more information, see Regions and zones, or call DescribeRegions to obtain the latest region list.
ImageId String Yes Indicates the ID of the custom image.
ImageName String No This parameter indicates the name of the custom image.
  • Can be [2, 128] characters in length.
  • Must begin with an uppercase or lowercase English letter.
  • Can contain digits, underscores (_), colons(:), or hyphens (-).
  • Cannot begin with http:// or https://.
Description String No This parameter indicates the description of a custom image.
  • Can be [0, 256] characters in length.
  • Cannot begin with http:// or https://.
  • The default value is null. If the parameter is left blank, the default value is used.

Response parameters

All parameters are common response parameters. For more information, see Common parameters.

Examples

Request example

  1. https://ecs.aliyuncs.com/?Action=ModifyImageAttribute
  2. &ImageId=m-281234567
  3. &RegionId=cn-qingdao
  4. &ImageName=testImage123
  5. &<Common Request Parameters>

Response example

XML format

  1. <ModifyImageAttributeResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. </ModifyImageAttributeResponse>

JSON format

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
  3. }

Error codes

Error code Error message HTTP status code Meaning
InvalidDescription.Malformed The specified description is wrongly formed. 400 The specified Description is invalid.
InvalidImageName.Duplicated The specified Image name has already bean used. 400 The specified ImageName already exists.
InvalidImageName.Malformed The specified Image name is wrongly formed. 400 The specified ImageName is invalid.
MissingParameter The input parameter "RegionId" that is mandatory for processing this request is not supplied. 400 You must specify the RegionId parameter.
InvalidImageId.NotFound The specified ImageId does not exist. 403 The specified ImageId does not exist.
InvalidRegionId.NotFound The specified region does not exist. 404 The specified region does not exist.
Thank you! We've received your feedback.