指定されたインスタンスの履歴イベントを記述します。先週のシステムイベント履歴を照会できます。
リクエストパラメーター
名前 | 型 | 必須かどうか | 説明 |
---|---|---|---|
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” …のような形式で表示する必要があります。オプションの値:
|
EventCycleStatus | String | いいえ | イベントのライフサイクルステータス。EventCycleStatus は、 InstanceEventCycleStatus.N が指定されていない場合にのみ有効です。オプションの値:
|
InstanceEventType.N | String | いいえ | 1 つまたは複数のインスタンスのイベントタイプ。値の範囲は N:[1,30]。イベントは、InstanceEventType.1=”Reboot” , InstanceEventType.2=”SystemFailure.Reboot” … のような形式で表示する必要があります。オプション値:
|
EventType | String | いいえ | インスタンスのイベントタイプ。EventType は、 InstanceEventType.N が指定されていない場合にのみ有効です。オプションの値:
|
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 です。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeInstanceHistoryEvents&RegionId=cn-hangzhou&InstanceId=i-2ze3tphuqvc93cixxxx3&<共通リクエストパラメーター>
成功したレスポンスの例
XML 形式
JSON 形式
<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>
{ “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 形式
JSON 形式
<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>
{ “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 | 内部エラーです。しばらくしてからもう一度お試しください。 |