指定されたインスタンスの履歴イベントを記述します。先週のシステムイベント履歴を照会できます。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい インターフェイスの名前。値: DescribeInstanceHistoryEvents
RegionId String はい インスタンスが配置されているリージョンの ID。詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。
InstanceId String いいえ インスタンス ID。インスタンス ID を指定しないと、指定されたリージョン内のすべてのインスタンスのイベント情報が取得されます。
EventId.N String いいえ 1 つまたは複数のイベント ID。値の範囲は N:[1, 100]。ID は EventId.1=”e-xhskHun1256xxxx”, EventId.2=”e-xhskHun1257xxxx” … のような形式で表示する必要があります。
InstanceEventCycleStatus.N String いいえ 1 つまたは複数のイベントのライフサイクルステータス。値の範囲は N:[1,100]。ステータスは InstanceEventCycleStatus1=”Scheduled”, InstanceEventCycleStatus2=”Canceled”…のような形式で表示する必要があります。オプションの値:
  • Scheduled:イベントは処理を待っています。
  • Avoided:イベントが完了する前に修正しました。
  • Executing:イベントは処理中です。
  • Executed:イベントの処理が完了しました。
  • Canceled:イベントがキャンセルされました。
  • Failed:イベントの処理に失敗しました。
EventCycleStatus String いいえ イベントのライフサイクルステータス。EventCycleStatusは、 InstanceEventCycleStatus.N が指定されていない場合にのみ有効です。オプションの値:
  • Scheduled
  • Avoided
  • Executing
  • Executed
  • Canceled
  • Failed
InstanceEventType.N String いいえ 1 つまたは複数のインスタンスのイベントタイプ。値の範囲は 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 入力時に設定された 1 ページあたりのエントリ数。
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 です。

リクエストの例
  1. https://ecs.aliyuncs.com/?Action=DescribeInstanceHistoryEvents&RegionId=cn-hangzhou&InstanceId=i-2ze3tphuqvc93cixxxx3&<共通リクエストパラメーター>
成功したレスポンスの例

XML 形式

  1. <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 形式
  1. { 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 形式

  1. <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 形式
  1. { 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 内部エラーです。しばらくしてからもう一度お試しください。