全部产品
Search
文档中心

云服务器 ECS:CreateSimulatedSystemEvents

更新时间:Sep 12, 2023

调用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

系统事件的类型。取值范围:

  • SystemMaintenance.Reboot:因系统维护实例重启。
  • SystemFailure.Reboot:因系统错误实例重启。
  • InstanceFailure.Reboot:因实例错误实例重启。
  • SystemMaintenance.Stop:因系统维护实例停止。
  • SystemMaintenance.Redeploy:因系统维护实例重新部署。
  • SystemFailure.Redeploy:因系统错误实例重新部署。
  • SystemFailure.Stop:因系统错误实例重新停止。
  • InstanceFailure.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 是否正确。

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