ModifyElasticityAssurance - 修改弹性保障服务信息 - 云服务器 ECS

修改一个弹性保障服务的部分信息，包含名称、描述、容量（暂时只支持缩容）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:ModifyElasticityAssurance

update

*ElasticityAssurance

acs:ecs:{#regionId}:{#accountId}:elasticityassurance/{#ElasticityAssuranceId}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	弹性保障服务所属地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
PrivatePoolOptions.Id	string	是	弹性保障服务 ID。	eap-bp67acfmxazb4****
PrivatePoolOptions.Name	string	否	弹性保障服务的名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头，不能以 http://和 https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。	eapTestName
Description	string	否	弹性保障服务的描述信息。长度为 2~256 个英文或中文字符，不能以`http://`和`https://`开头。	This is description.
InstanceAmount	integer	否	弹性保障服务需要预留的实例总数量。取值范围：已使用的实例数量~1000。该参数不能与其他参数同时修改。	10
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。	123e4567-e89b-12d3-a456-426655440000
RecurrenceRules	array<object>	否	弹性保障-分时保障重复规则列表。
	object	否	弹性保障-分时保障重复规则。说明修改后的重复规则将于次日生效。
RecurrenceType	string	否	重复规则的策略类型。取值范围： Daily：按天重复。 Weekly：按周重复。 Monthly：按月重复。说明必须同时指定`RecurrenceType`和`RecurrenceValue`。	Daily
RecurrenceValue	string	否	重复规则执行数值。 `RecurrenceType`为`Daily`时，只能填一个值，取值范围：1~31。表示每几天执行一次。 `RecurrenceType`为`Weekly`时，可以填入多个值，多个值间使用半角逗号（,）隔开。周日、周一、周二、周三、周四、周五、周六的值依次为：0,1,2,3,4,5,6。例如`1,2`表示周一和周二执行。 `RecurrenceType`为`Monthly`时，格式为`A-B`。A、B 的取值范围为 1~31，并且 B 必须大于等于 A。例如：`1-5`表示每月的 1~5 日重复执行。说明必须同时指定`RecurrenceType`和`RecurrenceValue`。	5
StartHour	integer	否	分时保障生效时间，取值必须为整点。说明同时指定`StartHour`和`EndHour`，且两者至少需要相差 4 小时。	4
EndHour	integer	否	分时保障结束时间，取值必须为整点。	10

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	8455DD10-84F8-43C9-8365-5F448EB169B6

示例

正常返回示例

JSON格式

{
  "RequestId": "8455DD10-84F8-43C9-8365-5F448EB169B6"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidRecurrenceRules.CountLimitExceeded	The count of RecurrenceRules exceeds the limit.	参数RecurrenceRules的个数超过限定值。
400	InvalidRecurrenceRules.Unsupported	The specified parameter RecurrenceRules does not support for this resource package.	该资源包不支持指定参数RecurrenceRules。
400	InvalidRecurrenceRulesStartHourEndHour.TooShort	The recurrence hour between RecurrenceRules.StartHour and RecurrenceRules.EndHour is too short.	参数RecurrenceRules.StartHour和RecurrenceRules.EndHour之间的生效时间小于最小要求。
400	InvalidParameter.RecurrenceRulesStartHourEndHour	The specified parameter RecurrenceRules.StartHour or RecurrenceRules.EndHour is invalid.	为RecurrenceRules指定的参数RecurrenceRules.StartHour或RecurrenceRules.EndHour不符合规范。
400	InvalidParameter.RecurrenceRulesRecurrenceValueMonthly	The specified parameter RecurrenceRules.RecurrenceValue for Monthly is invalid.	为RecurrenceRules.RecurrenceType=Monthly指定的参数RecurrenceRules.RecurrenceValue不符合规范。
400	InvalidParameter.RecurrenceRulesRecurrenceValueWeekly	The specified parameter RecurrenceRules.RecurrenceValue for Weekly is invalid.	为RecurrenceRules.RecurrenceType=Weekly指定的参数RecurrenceRules.RecurrenceValue不符合规范。
400	InvalidParameter.RecurrenceRulesRecurrenceValueDaily	The specified parameter RecurrenceRules.RecurrenceValue for Daily is invalid.	为RecurrenceRules.RecurrenceType=Daily指定的参数RecurrenceRules.RecurrenceValue不符合规范。
400	InvalidParameter.RecurrenceRulesRecurrenceType	The specified parameter RecurrenceRules.RecurrenceType is invalid.	指定的参数RecurrenceRules.RecurrenceType不符合规范。
400	InvalidInstanceAmount.ValueNotSupported	The specified parameter InstanceAmount is not valid.
400	InvalidDescription.ValueNotSupported	The specified Description is invalid.
400	InvalidEndTime.ValueNotSupported	The specified EndTime is invalid.
400	InvalidStartTime.ValueNotSupported	The specified StartTime is invalid.
400	InvalidParameter.PrivatePoolOptions.Name	The parameter PrivatePoolOptions.Name is invalid.	指定的参数PrivatePoolOptions.Name不符合要求。
400	InvalidParameter.ClientToken	The parameter ClientToken is invalid.	指定的参数ClientToken不符合要求。
400	InvalidParameter.Description	The parameter Description is invalid.	指定的参数Description不符合要求。
401	InvalidUser.Unauthorized	The user is not authorized.	您当前使用的账号无权限。
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidOperation.ModifyTotalActiveTimeUnsupported	Not support to modify the total active time of resource package.	不支持修改资源包的总生效时间。
403	IncorrectPrivatePoolStatus	The current status of the private pool does not support this operation.	参数中指定的私有池状态不支持当前操作
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	库存不足。
403	InvalidPrivatePoolOptionsName.ValueNotSupported	The specified PrivatePoolOptions.Name is invalid.
403	InvalidPlatform.ValueNotSupported	The specified Platform is invalid.
403	OperationDenied.PlatformNotSupported	The specified private pool does not support this operation.
403	OperationDenied.EndTimeTypeNotSupported	The specified private pool does not support this operation.
403	OperationDenied.StartTimeNotSupported	The specified private pool does not support this operation.
403	OperationDenied.InstanceAmountNotSupported	The specified private pool does not support this operation.
403	InvalidInstanceAmount.ValueNotSupported	The specified InstanceAmount is invalid.
403	InvalidPrivatePoolOptions.Id	The specified private pool does not support this operation.
403	InvalidInstanceAmount.LessThanUsedAmount	The specified parameter InstanceAmount is less than UsedAmount.	指定的参数InstanceAmount小于已使用容量。
403	InvalidOperation.InstanceAmountAndOtherAttributesUnsupported	Modify InstanceAmount and other attributes simultaneously is not supported.	不支持InstanceAmount和其他属性同时修改。
403	QuotaExceed.ElasticityAssuranceCapacity	ElasticityAssurance Capacity quota exceeded.	弹性保障服务容量配额超出限制。
404	InvalidPrivatePoolId.NotFound	The specified private pool does not exist.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。