全部产品
  • 首页 > 
  • SetInstancesSystemEvent

SetInstancesSystemEvent

描述

设置模拟的 系统事件

基于该接口,您可以调试自己开发的自动化处理系统事件的程序,并校验演练。我们不会执行真正的系统事件,只是模拟系统事件的状态变化,在您指定的 NotBefore 时间点,系统事件状态变为 Executed。您指定的 NotBefore 时间点等同于系统事件的 PublishTime

系统事件演练后,您可以通过 DescribeInstancesFullStatus 查询处于 Scheduled 状态的系统事件。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:SetInstancesSystemEvent
RegionId String 实例所在的地域 ID。更多详情,请参阅 地域与可用区,或者调用 DescribeRegions 查看最新的阿里云地域列表。
InstanceId.N String 实例 ID,N 的取值范围:[1, 100]。
EventType String 实例的事件类型。取值范围:
  • Reboot:实例重启
  • Redeploy:实例更换宿主机重启,本地盘初始化
  • SystemFailure.Reboot:因系统错误实例重启
  • SystemFailure.Redeploy:因系统错误实例更换宿主机重启,本地盘初始化
  • SystemFailure.Stop:因系统错误实例停止
  • SystemFailure.Delete:因系统错误实例释放
NotBefore String 系统事件预计的执行时间。按照 ISO8601 标准表示,并使用 UTC 时间,格式为 YYYY-MM-DDTHH:mm:ssZ。

返回参数

名称 类型 描述
EventIdSet Array of EventId 已设置的系统事件的 EventId 数组

EventId 数据类型

名称 类型 描述
EventId String 事件 ID

示例

请求示例

   
  1. https://ecs.aliyuncs.com/?Action=SetInstancesSystemEvent
  2. &RegionId=cn-hangzhou
  3. &InstanceId_1="i-instance1"
  4. &InstanceId_2="i-instance2"
  5. &EventType="SystemFailure.Stop"
  6. &NotBefore="2018-04-01T06:32:31Z"
  7. &<公共请求参数>

正常返回示例

XML 格式

   
  1. <SetInstancesSystemEventResponse>
  2. <EventIdSet>
  3. <EventId>e-event1</EventId>
  4. <EventId>e-event2</EventId>
  5. </EventIdSet>
  6. <RequestId>AAC49D3E-ED6F-4F00-XXXX-377C551B1DD4</RequestId>
  7. </SetInstancesSystemEventResponse>

JSON 格式

   
  1. {
  2. "EventIdSet": {
  3. "EventId": ["e-event1", "e-event2"]
  4. },
  5. "RequestId": "AAC49D3E-ED6F-4F00-XXXX-377C551B1DD4"
  6. }

异常返回示例

XML 格式

   
  1. <Error>
  2. <RequestId>C38E0D94-C18B-44F3-8C05-6E35BE334088</RequestId>
  3. <HostId>ecs.aliyuncs.com</HostId>
  4. <Code>InvalidNotBefore.Passed</Code>
  5. <Message>The NotBefore of system event has passed.</Message>
  6. </Error>

JSON 格式

   
  1. {
  2. "RequestId": "C38E0D94-C18B-44F3-8C05-6E35BE334088",
  3. "HostId": "ecs.aliyuncs.com",
  4. "Code": "InvalidNotBefore.Passed",
  5. "Message": "The NotBefore of system event has passed."
  6. }

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidParameter The Parameter provided is not valid. 403 请求参数不合法。
InstanceIdLimitExceeded The amount of InstanceId specified exceeds limit 100. 403 指定的 InstanceId.N 参数值个数超出了合法范围。
InvalidInstanceId.Empty The InstanceId should not be empty. 403 您必须指定参数 InstanceId.N
InvalidNotBefore.Passed The NotBefore of system event has passed. 403 您指定的 NotBefore 不能迟于当前时间。
MissingParameter The input parameter that is mandatory for processing this request is not supplied. 403 您必须指定必需参数。
SetEventLimitExceeded The amount of scheduled system events set by user exceeds limit 1000. 403 处于 Scheduled 状态的系统事件个数不能超过 1000 件。
InvalidInstanceId.NotFound Cannot find all specified InstanceId. 404 指定的 InstanceId 不存在。
InternalError The request processing has failed due to some unknown error,exception or failure. 500 内部错误。请稍后再试。