ModifyInstanceMaintenanceAttributes - 修改实例的维护属性 - 云服务器 ECS

调用ModifyInstanceMaintenanceAttributes修改实例的维护属性。

接口说明

修改实例的维护策略，策略中包含两个维护属性。

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

操作

访问级别

资源类型

条件关键字

关联操作

ecs:ModifyInstanceMaintenanceAttributes

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

无

名称	类型	必填	描述	示例值
RegionId	string	是	实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
ActionOnMaintenance	string	否	维护动作。取值范围： Stop：停止状态（即宕机）。 AutoRecover：自动恢复。 AutoRedeploy：宕机迁移，数据盘有损。	AutoRecover
NotifyOnMaintenance	boolean	否	实例宕机运维前是否发送事件通知。取值范围： true：发送事件通知。 false：不发送事件通知。默认值：false	false
InstanceId	array	否	实例 ID。N 的取值范围为：1~100。	i-bp67acfmxazb4ph****
	string	否	实例 ID。N 的取值范围为：1~100。	i-bp67acfmxazb4ph****
MaintenanceWindow	array<object>	否	维护时间窗口列表。
	object	否	维护时间窗口列表。
EndTime	string	否	维护时间窗口结束时间。必须为整小时，不允许设置分、秒。开始时间和结束时间必须同时设置，并且结束时间与开始时间需要间隔 1~23 个整小时。采用 UTC +8 时区，格式为`HH:mm:ss`。N 的取值为 1，只支持设置 1 个时间窗口。	18:00:00
StartTime	string	否	维护时间窗口开始时间。必须为整小时，不允许设置分、秒。开始时间和结束时间必须同时设置，并且结束时间与开始时间需要间隔 1~23 个整小时。采用 UTC +8 时区，格式为`HH:mm:ss`。N 的取值为 1，只支持设置 1 个时间窗口。	02:00:00

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

HTTP status code	错误码	错误信息	描述
403	InvalidParameter	%s
403	OperationDenied.NotInWhiteList	%s	该操作无效，请先加入白名单。
404	InvalidInstanceId.NotFound	%s

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

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