ModifyImageAttribute_云服务器 ECS_API文档

2014-05-26

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为1000/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:ModifyImageAttribute	Update	Image acs:ecs:{#regionId}:{#accountId}:image/{#imageId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	自定义镜像所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
ImageIdstring	自定义镜像的 ID。示例值:m-bp18ygjuqnwhechc****参考取值来源: ImportImage CopyImage ExportImage CreateImage DescribeImages
ImageNamestring	自定义镜像的名称。长度为 2~128 个字符。必须以大小字母或中文开头，不能以 aliyun 或 acs:开头，不能包含 http://或者 https://。可以包含数字、半角句号（.）、半角冒号（:）、下划线（_）或者短划线（-）。展开详情示例值:testImageName参考取值来源: DescribeImages
Statusstring	镜像状态，取值范围：展开详情示例值:Deprecated
ImageFamilystring	镜像族系名称。长度为 2~128 个字符。必须以大小字母或中文开头，不能以 aliyun 或 acs:开头，不能包含 http://或者 https://。可以包含数字、半角句号（.）、半角冒号（:）、下划线（_）或者短划线（-）。展开详情示例值:hangzhou-daily-update参考取值来源: DescribeImages
BootModestring	修改镜像的启动模式。取值范围：展开详情示例值:BIOS枚举值:BIOSUEFIUEFI-Preferred
LicenseTypestring	导入镜像后，激活操作系统采用的许可证类型。当前仅支持 BYOL。展开详情示例值:BYOL
Descriptionstring	自定义镜像的描述信息。长度为 2~256 个字符。不能以 http://或 https://开头。展开详情示例值:testDescription
Featuresobject	镜像特性相关属性。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidImageName.Malformed	Image names must be between 2 and 128 characters long, using either English or Chinese characters. The name must start with a letter or a Chinese character, and can include numbers, colons, underscores and hyphens.	诊断
400	MissingParameter	The input parameter "RegionId" that is mandatory for processing this request is not supplied.	诊断
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	诊断
400	InvalidDescription.Malformed	The specified description is wrongly formed.	诊断
400	ImageQuotaFull.ImageFamily	The specified image family has exceeded max number of images for one image family.	诊断
400	InvalidImageFamily.Malformed	The specified parameter "ImageFamily" is malformed.	诊断
400	ImageFamilyQuotaFull	The specified region has exceeded max number of image family.	诊断
400	InvalidBootMode.NotSupport	The specified parameter BootMode is not supported.	诊断
400	InvalidLicenseType.NotSupported	The specified parameter LicenseType is not supported.	诊断
400	InvalidParameter.FeaturesImdsSupport	The specified parameter Features.ImdsSupport is not supported.	诊断
403	ImageStatus.NotAvailable	The specified image status is not available.	诊断
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	诊断
403	ImageUseShared	The specified image has been shared to others, please remove shared accounts first.	诊断
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	诊断
403	InvalidOperation.FeaturesImdsSupportNotMatch	The specified parameter Features.ImdsSupport can not be set to v1 from v2.	诊断
403	InvalidStatus.ImageIsCreating	The operation cannot be performed because the image is creating. Please wait until the creation is complete and try again.	诊断
404	InvalidImageId.NotFound	The specified ImageId does not exist.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-04-01	变更错误码403
	2025-02-27	变更错误码400
	2024-12-05	变更错误码400 变更错误码403 变更请求参数Features
	2022-11-30	变更错误码403

1
2
10 条/页

相关示例