更新运维窗口
接口说明
修改运维窗口的属性。当运维窗口 TargetResource 参数设置关联的 ECS 实例，底层发生硬件隐患，需要通过计划运维来规避的时候，计划运维的执行时间会根据运维窗口 TimePeriod 参数设置的区间来设置。当到达运维事件的执行时间后，平台会自动根据运维事件的类型来执行响应的运维操作
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecs:ModifyPlanMaintenanceWindow |
update |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| PlanWindowId |
string |
是 |
需要修改的运维窗口的 Id。必传参数。 |
pw-bp1au1w8v8a1yer65g5k |
| PlanWindowName |
string |
否 |
运维创建名称，无需修为空。 |
WIndowName |
| Enable |
boolean |
否 |
启用或禁用窗口。无需修改为空。 |
false |
| SupportMaintenanceAction |
string |
否 |
支持的运维动作。无需修改为空。 |
Reboot |
| RegionId |
string |
是 |
实例所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| TimePeriod |
object |
否 |
窗口循环周期。无需修改为空。 |
|
| PeriodUnit |
string |
否 |
周期的类型，每日循环 Daily,每周循环 Weekly。 |
Year |
| RangeList |
array<object> |
否 |
运维窗口循环周期的时间段（UTC 时区） |
|
|
object |
否 |
|||
| StartTime |
string |
否 |
运维窗口的开始时间
|
Monday,22:00 |
| EndTime |
string |
否 |
运维窗口的结束时间
|
Tuesday,03:00 |
| TargetResource |
object |
否 |
运维窗口生效的资源，无需修改为空 |
|
| Scope |
string |
否 |
配置运维窗口的资源类型 |
Tag |
| ResourceGroupId |
string |
否 |
运维窗口生效的资源组 ID。仅在 Scope 为 ResourceGroup 时需要填写 |
rg-acfmy4cc27vsvia |
| Tags |
array<object> |
否 |
运维窗口生效的标签，仅在 Scope 为 Tag 时需要填写 |
|
|
object |
否 |
|||
| Key |
string |
否 |
窗口生效的 tag 的 Key |
tagKey |
| Value |
string |
否 |
窗口生效的 tag 的 value |
tagValue |
| MinMaintenanceInterval |
integer |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
接口请求的 RequestID |
F3CD6886-D8D0-4FEE-B93E-1B732396**** |
示例
正常返回示例
JSON格式
{
"RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | InternalError | Internal error. | 发生未知错误。 |
| 403 | AccessForbidden | User not authorized to operate on the specified resource. | 您未被授权使用指定的资源。 |
| 403 | InvalidParameter.TimePeriod | Invalid Parameter Time Period. | Time Period 属性错误。 |
| 403 | InvalidParameter.TargetResource | Invalid Parameter Target Resource. | TargetResource 属性设置错误。 |
| 403 | InvalidParameter.SupportMaintenanceAction | Invalid Parameter SupportMaintenanceAction. | SupportMaintenanceAction 属性设置错误。 |
| 403 | InvalidParameter.MinMaintenanceInterval | Invalid Parameter MinMaintenanceInterval. | MinMaintenanceInterval 参数设置错误 |
| 404 | InvalidResource.NotFound | The specified resource not exists. | 指定的资源不存在 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。