为一台或多台ECS实例预约模拟系统事件。模拟系统事件相当于事件演习,不会真正执行事件,也不会对ECS实例产生影响。
描述
预约模拟事件后,您可以通过ECS管理控制台、ECS API 和云监控服务查看已经预约的模拟系统事件。
下表为模拟系统事件的生命周期:
- Scheduled(计划中):预约后,模拟系统事件自动切换为Scheduled状态。
- Executed(已完成):在没有人为干预的情况下,模拟系统事件在指定时间点(NotBefore)自动变成Executed状态。
- Canceled(已取消):您调用 CancelSimulatedSystemEvents 取消模拟系统事件后,变成Canceled状态。
- Avoided(已避免):对于因系统维护实例重启(SystemMaintenance.Reboot)的模拟系统事件,可以通过在指定时间点前 重启实例 而变成Avoided状态。
调试
前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
EventType | String | 是 | SystemMaintenance.Reboot |
系统事件的类型。取值范围:
|
InstanceId.N | RepeatList | 是 | i-instance1 |
一个或者多个ECS实例ID。N的取值范围:1~100,多个取值使用重复列表的形式。 |
NotBefore | String | 是 | 2018-12-01T06:32:31Z |
事件计划执行时间的开始时间。按照 ISO8601 标准表示,并需要使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
Action | String | 否 | CreateSimulatedSystemEvents |
系统规定参数。取值:CreateSimulatedSystemEvents |
OwnerAccount | String | 否 | ECSforCloud@Alibaba.com |
RAM 用户的账号登录名称。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
EventIdSet | e-xhskHun1256xxxx |
模拟事件ID(EventId)列表。 |
|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateSimulatedSystemEvents
&EventType=SystemMaintenance.Reboot
&InstanceId.1=i-instance1
&NotBefore=2018-12-01T06:32:31Z
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<CreateSimulatedSystemEventsResponse>
<EventIdSet>
<EventId>e-xhskHun1256xxxx</EventId>
<EventId>e-xhskHun1257xxxx</EventId>
</EventIdSet>
<RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
</CreateSimulatedSystemEventsResponse>
JSON
格式
{
"EventIdSet":{
"EventId":"e-xhskHun1257xxxx"
},
"RequestId":"E69EF3CC-94CD-42E7-8926-F133B86387C0"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | MissingParameter | %s | 缺失必需参数。 |
403 | InvalidParameter | %s | 参数格式不正确。 |
403 | InvalidNotBefore.Passed | %s | 指定的NotBefore不得早于当前时间。 |
404 | InvalidInstanceId.NotFound | %s | 指定的实例不存在。 |
403 | SimulatedEventLimitExceeded | %s | 已达到可设置模拟事件的个数上限。 |
403 | InstanceIdLimitExceeded | %s | 指定的InstanceId个数不得超过100个。 |
查看本产品错误码
发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1872.html