全部產品
Search
文件中心

Elastic Compute Service:CreateSimulatedSystemEvents

更新時間:Jun 18, 2026

為一台或多台 ECS 執行個體預約模擬系統事件。模擬系統事件相當於事件演習,不會真正執行事件,也不會對 ECS 執行個體產生影響。

介面說明

預約模擬事件後,您可以透過 ECS 管理控制台、ECS API和雲端監控服務查看已經預約的模擬系統事件。

下表為模擬系統事件的生命週期:

  • Scheduled(計劃中):預約後,模擬系統事件自動切換為 Scheduled 狀態。

  • Executed(已完成):在沒有人為干預的情況下,模擬系統事件在指定時間點(NotBefore)自動變成 Executed 狀態。

  • Canceled(已取消):您呼叫 CancelSimulatedSystemEvents 取消模擬系統事件後,變成 Canceled 狀態。

  • Avoided(已避免):對於因系統維護執行個體重啟(SystemMaintenance.Reboot)的模擬系統事件,可以透過在指定時間點前重啟執行個體而變成 Avoided 狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:CreateSimulatedSystemEvents

create

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。

cn-hangzhou

RegionId

string

地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou

EventType

string

系統事件的類型。取值範圍:

  • SystemMaintenance.Reboot:因系統維護執行個體重啟

  • SystemFailure.Reboot:因系統錯誤執行個體重啟

  • InstanceFailure.Reboot:因執行個體錯誤執行個體重啟

  • SystemMaintenance.Stop:因系統維護執行個體停止

  • SystemMaintenance.Redeploy:因系統維護執行個體重新部署

  • SystemFailure.Redeploy:因系統錯誤執行個體重新部署

  • SystemFailure.Stop:因系統錯誤執行個體重新停止

  • InstanceFailure.Reboot:因執行個體錯誤執行個體重啟。

SystemMaintenance.Reboot

NotBefore

string

事件計劃執行的開始時間。按照 ISO8601 標準表示,並使用 UTC +0 時間,格式為 yyyy-MM-ddTHH:mm:ssZ。

說明

對於系統錯誤或執行個體錯誤導致的異常事件,建立事件後,事件已處於正在執行(Executing)狀態,此時參數NotBefore為事件進入完成執行(Executed)狀態的時間。

2018-12-01T06:32:31Z

InstanceId

array

ECS 執行個體 ID 列表資訊。可輸入最多 100 個執行個體 ID。

i-bp1gtjxuuvwj17zr****

string

執行個體 ID。

i-bp1gtjxuuvwj17zr****

返回參數

名稱

類型

描述

樣本值

object

請求 ID。

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

EventIdSet

object

EventId

array

模擬事件 ID(EventId)列表。

string

模擬事件 ID(EventId)。

e-bp16helosl7v0ooj****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "EventIdSet": {
    "EventId": [
      "e-bp16helosl7v0ooj****"
    ]
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

403 InvalidParameter %s
403 InvalidNotBefore.Passed %s
403 SimulatedEventLimitExceeded %s
403 InstanceIdLimitExceeded %s
404 MissingParameter %s
404 InvalidInstanceId.NotFound %s

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情