DescribeInstanceHistoryEvents - Elastic Compute Service

請求參數


名稱	類型	是否必需	描述
Action	String	是	系統規定參數。取值：DescribeInstanceHistoryEvents
RegionId	String	是	執行個體所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId	String	否	執行個體 ID。不指定執行個體 ID 時，表示查詢您指定地域下所有執行個體的事件資訊。
EventId.N	String	否	一個或者多個事件 ID。N 的取值範圍：[1, 100]，多個取值使用重複列表的形式，樣本 `EventId.1="e-xhskHun1256xxxx"`，`EventId.2="e-xhskHun1257xxxx"` ……
InstanceEventCycleStatus.N	String	否	一個或者多個事件的生命週期狀態。N 的取值範圍：[1, 6]，多個取值使用重複列表的形式，樣本 `InstanceEventCycleStatus.1="Scheduled"`，`InstanceEventCycleStatus.2="Canceled"`……。取值範圍： Scheduled：等待執行事件 Avoided：事件已避免 Executing：事件執行中 Executed：事件已完成執行 Canceled：事件已取消 Failed：事件執行失敗
EventCycleStatus	String	否	事件的生命週期狀態。`EventCycleStatus` 只在未指定 `InstanceEventCycleStatus.N` 參數時有效。取值範圍： Scheduled Avoided Executing Executed Canceled Failed
InstanceEventType.N	String	否	一個或者多個事件的類型。N 的取值範圍：[1, 30]，多個取值使用重複列表的形式，樣本 `InstanceEventType.1="Reboot"`，`InstanceEventType.2="SystemFailure.Reboot"`……。取值範圍： SystemMaintenance.Reboot：因系統維護執行個體重啟 SystemFailure.Reboot：因系統錯誤執行個體重啟 InstanceFailure.Reboot：因執行個體錯誤執行個體重啟
EventType	String	否	事件的類型。`EventType` 參數只在未指定 `InstanceEventType.N` 參數時有效。取值範圍： SystemMaintenance.Reboot SystemFailure.Reboot InstanceFailure.Reboot
NotBefore.Start	String	否	查詢事件計劃執行時間的開始時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
NotBefore.End	String	否	查詢事件計劃執行時間的結束時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
EventPublishTime.Start	String	否	查詢事件發布時間的開始時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
EventPublishTime.End	String	否	查詢事件發布時間的結束時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
PageNumber	Integer	否	查詢結果的頁碼。取值範圍：正整數預設值：1
PageSize	Integer	否	查詢結果的分頁大小。取值範圍：[1, 100] 預設值：10

返回參數


名稱	類型	描述
TotalCount	Integer	執行個體狀態總個數
PageNumber	Integer	執行個體列表頁碼
PageSize	Integer	輸入時設定的每頁行數
InstanceSystemEventSet	Array of InstanceSystemEventType	執行個體曆史事件數目組

資料類型 InstanceSystemEventType


名稱	類型	描述
InstanceId	String	執行個體 ID
EventId	String	事件 ID
EventType.Code	Integer	事件類型代碼
EventType.Name	String	事件類型名稱
EventCycleStatus.Code	Integer	事件狀態碼
EventCycleStatus.Name	String	事件狀態名稱
EventPublishTime	String	事件發布時間。按照 ISO8601 標準表示，並使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
NotBefore	String	事件計劃執行時間。按照 ISO8601 標準表示，並使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
EventFinishTime	String	事件結束時間。按照 ISO8601 標準表示，並使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。

樣本

請求樣本

https://ecs.aliyuncs.com/?Action=DescribeInstanceHistoryEvents
&RegionId=cn-hangzhou
&InstanceId=i-2ze3tphuqvc93cixxxx3
&<公共請求參數>

正常返回樣本

XML 格式

<DescribeInstanceHistoryEventsResponse>
    <InstanceSystemEventSet>
        <InstanceSystemEventType>
            <InstanceId>i-2ze3tphuqvc93cixxxx3</InstanceId>
            <EventId>e-2ze9yxxxxwtqcvai68rl</EventId>
            <EventType>
                <Code>1</Code>
                <Name>SystemMaintenance.Reboot</Name>
            </EventType>
            <EventCycleStatus>
                <Code>0</Code>
                <Name>Executed</Name>
            </EventCycleStatus>
            <EventPublishTime>2017-11-30T06:32:31Z</EventPublishTime>
            <NotBefore>2017-12-01T06:32:31Z</NotBefore>
            <EventFinishTime>2017-12-01T06:35:31Z</EventFinishTime>
        </InstanceSystemEventType>
        <InstanceSystemEventType>
            <InstanceId>i-2ze3tphuqvc93cixxxx3</InstanceId>
            <EventId>e-2ze9yxxxxwtqcvai68r3</EventId>
            <EventType>
                <Code>34</Code>
                <Name>InstanceExpiration.Stop</Name>
            </EventType>
            <EventCycleStatus>
                <Code>8</Code>
                <Name>Avoided</Name>
            </EventCycleStatus>
            <EventPublishTime>2017-11-29T06:32:31Z</EventPublishTime>
            <NotBefore>2017-12-06T00:00:00Z</NotBefore>
            <EventFinishTime>2017-12-05T12:35:31Z</EventFinishTime>
        </InstanceSystemEventType>
    </InstanceSystemEventSet>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <RequestId>02EA76D3-5A2A-44EB-XXXX-8901881D8707</RequestId>
</DescribeInstanceHistoryEventsResponse>

JSON 格式

{
  "InstanceSystemEventSet": {
    "InstanceSystemEventType": [
      {
        "InstanceId": "i-2ze3tphuqvc93cixxxx3",
        "EventId": "e-2ze9yxxxxwtqcvai68rl",
        "EventType": {
          "Code": 1,
          "Name": "SystemMaintenance.Reboot"
        },
        "EventCycleStatus": {
          "Code": 0,
          "Name": "Executed"
        },
        "EventPublishTime": "2017-11-30T06:32:31Z",
        "NotBefore": "2017-12-01T06:32:31Z",
        "EventFinishTime": "2017-12-01T06:35:31Z"
      },
      {
        "InstanceId": "i-2ze3tphuqvc93cixxxx3",
        "EventId": "e-2ze9yxxxxwtqcvai68r3",
        "EventType": {
          "Code": 34,
          "Name": "InstanceExpiration.Stop"
        },
        "EventCycleStatus": {
          "Code": 8,
          "Name": "Avoided"
        },
        "EventPublishTime": "2017-11-29T06:32:31Z",
        "NotBefore": "2017-12-06T00:00:00Z",
        "EventFinishTime": "2017-12-05T12:35:31Z"
      }
    ]
  },
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 2,
  "RequestId": "02EA76D3-5A2A-44EB-XXXX-8901881D8707"
}

異常返回樣本

XML 格式

<Error>
    <RequestId>C38E0D94-C18B-44F3-8C05-6E35BE334087</RequestId>
    <HostId>ecs.aliyuncs.com</HostId>
    <Code>InvalidParameter</Code>
    <Message>The Parameter "EventCycleStatus" provided is not valid.</Message>
</Error>

JSON 格式

{
    "RequestId": "1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C212",
    "HostId": "ecs.aliyuncs.com"
    "Code": "InvalidParameter"
    "Message": "The Parameter "EventCycleStatus" provided is not valid."
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。


錯誤碼	錯誤資訊	HTTP 狀態碼	說明
InvalidParameter	The Parameter provided is not valid.	403	請求參數不合法。
EventIdLimitExceeded	The amount of EventId specified exceeds limit 100.	403	指定的 `EventId` 參數值個數不能超過 100 個。
MissingParameter	The input parameter that is mandatory for processing this request is not supplied.	403	輸入的參數缺少必填項。
InternalError	The request processing has failed due to some unknown error, exception or failure.	500	內部錯誤。