CreateSimulatedSystemEvents - Elastic Compute Service

介面說明

預約模擬事件後，您可以透過 ECS 管理主控台、ECS API和雲端監控服務檢視已經預約的模擬系統事件。

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

Scheduled（計畫中）：預約後，模擬系統事件自動切換為 Scheduled 狀態。
Executed（已完成）：在沒有人為干預的情況下，模擬系統事件在指定時間點（NotBefore）自動變成 Executed 狀態。
Canceled（已取消）：您呼叫 CancelSimulatedSystemEvents 取消模擬系統事件後，變成 Canceled 狀態。
Avoided（已避免）：對於因系統維護執行個體重新啟動（SystemMaintenance.Reboot）的模擬系統事件，可以透過在指定時間點前重新啟動執行個體而變成 Avoided 狀態。

當設定 TriggerRealOps 參數為 true 時有以下注意事項：

警告系統將真實執行執行個體的停機或釋放操作，存在資料遺失風險，需要謹慎測試，或選擇無業務的執行個體進行測試。
EventType 僅支援 SystemMaintenance.Reboot、SystemMaintenance.Redeploy、SystemMaintenance.Stop、InstanceFailure.Reboot、SystemFailure.Reboot 和 Instance:PreemptibleInstanceInterruption。
當 EventType 為 SystemMaintenance.Redeploy 時，NotBefore 參數無效，事件的執行時間由系統自動產生。

調試

您可以在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
EventType	string	是	系統事件的類型。取值範圍： SystemMaintenance.Reboot：因系統維護執行個體重新啟動。 SystemFailure.Reboot：因系統錯誤執行個體重新啟動。 InstanceFailure.Reboot：因執行個體錯誤執行個體重新啟動。 SystemMaintenance.Stop：因系統維護執行個體停止。 SystemMaintenance.Redeploy：因系統維護執行個體重新部署。 SystemFailure.Redeploy：因系統錯誤執行個體重新部署。 SystemFailure.Stop：因系統錯誤執行個體重新停止。 InstanceFailure.Reboot：因執行個體錯誤執行個體重新啟動。	SystemMaintenance.Reboot
NotBefore	string	是	事件計畫執行的開始時間。按照ISO 8601標準表示，並使用 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****
TriggerRealOps	boolean	否	是否觸發真實維運操作。取值範圍： - true：觸發真實維運，系統將真實執行執行個體的停機或釋放操作，需要謹慎測試，或選擇無業務的執行個體進行測試。 - false（預設值）：僅模擬事件通知，不影響執行個體實際生命週期。	false

返回參數

名稱	類型	描述	樣本值
	object	請求 ID。
EventIdSet	object
EventId	array	模擬事件 ID（EventId）清單。
	string	模擬事件 ID（EventId）。	e-bp16helosl7v0ooj****
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
403	InvalidParameter	%s
403	InvalidNotBefore.Passed	%s	指定的 NotBefore 不能早於目前時間。
403	SimulatedEventLimitExceeded	%s	超出模擬事件限制。
403	InstanceIdLimitExceeded	%s	指定的 InstanceId 個數不能超過 100 個。
404	MissingParameter	%s
404	InvalidInstanceId.NotFound	%s

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

變更歷史

更多資訊，參考變更詳情。