调用CreateSimulatedSystemEvents为一台或多台ECS实例预约模拟系统事件。模拟系统事件相当于事件演习,不会真正执行事件,也不会对ECS实例产生影响。
接口说明
预约模拟事件后,您可以通过ECS管理控制台、ECS API和云监控服务查看已经预约的模拟系统事件。
下表为模拟系统事件的生命周期:
- Scheduled(计划中):预约后,模拟系统事件自动切换为Scheduled状态。
- Executed(已完成):在没有人为干预的情况下,模拟系统事件在指定时间点(NotBefore)自动变成Executed状态。
- Canceled(已取消):您调用CancelSimulatedSystemEvents取消模拟系统事件后,变成Canceled状态。
- Avoided(已避免):对于因系统维护实例重启(SystemMaintenance.Reboot)的模拟系统事件,可以通过在指定时间点前重启实例而变成Avoided状态。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | CreateSimulatedSystemEvents | 系统规定参数。取值:CreateSimulatedSystemEvents。 |
RegionId | String | 是 | cn-hangzhou | 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
EventType | String | 是 | SystemMaintenance.Reboot | 系统事件的类型。取值范围:
|
NotBefore | String | 是 | 2018-12-01T06:32:31Z | 事件计划执行的开始时间。按照ISO 8601标准表示,并使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 说明 对于系统错误或实例错误导致的异常事件,创建事件后,事件已处于正在执行( Executing )状态,此时参数NotBefore 为事件进入完成执行(Executed )状态的时间。 |
InstanceId.N | String | 否 | i-bp1gtjxuuvwj17zr**** | 实例ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 请求ID。 |
EventIdSet | Array of String | e-bp16helosl7v0ooj**** | 模拟事件ID(EventId)。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateSimulatedSystemEvents
&EventType=SystemMaintenance.Reboot
&InstanceId.1=i-bp1gtjxuuvwj17zr****
&NotBefore=2018-12-01T06:32:31Z
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateSimulatedSystemEventsResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<EventIdSet>" EventId " : [ " e-bp16helosl7v0ooj**** " ]</EventIdSet>
</CreateSimulatedSystemEventsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"EventIdSet" : [ "\" EventId \" : [ \" e-bp16helosl7v0ooj**** \" ]" ]
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
403 | InvalidParameter | %s | 无效的参数。 |
403 | InvalidNotBefore.Passed | %s | 指定的 NotBefore 不能早于当前时间。 |
403 | SimulatedEventLimitExceeded | %s | 超出模拟事件限制。 |
403 | InstanceIdLimitExceeded | %s | 指定的 InstanceId 个数不能超过 100 个。 |
404 | MissingParameter | %s | 缺失参数,请检查参数是否完整。 |
404 | InvalidInstanceId.NotFound | %s | 指定的实例不存在,请确认参数 InstanceId 是否正确。 |
访问错误中心查看更多错误码。