すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:DescribeInstanceHistoryEvents

最終更新日:Oct 16, 2026

指定されたインスタンスのシステムイベントを照会します。デフォルトでは、この操作で非アクティブ状態の過去のシステムイベントを照会します。InstanceId、EventType などのパラメーターを指定できます。

操作説明

  • 過去 30 日以内に発生した完了済みの過去のシステムイベントをクエリできます。未完了のシステムイベントのクエリに時間制限はありません。

  • EventCycleStatus パラメーターおよび InstanceEventCycleStatus パラメーターを指定しない場合、クエリ結果にはデフォルトで Avoided、Executed、Canceled、Failed 状態のシステムイベントのみが含まれます。

  • InstanceEventCycleStatus パラメーターを指定すると、Scheduled、Executing、Inquiring 状態のシステムイベントもクエリできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:DescribeInstanceHistoryEvents

get

*All resources

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

リソースのリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

cn-hangzhou

InstanceId

string

任意

インスタンスの ID。このパラメーターを指定しない場合、指定されたリージョン内のすべてのインスタンスのシステムイベントが照会されます。

i-uf678mass4zvr9n1****

EventCycleStatus

string

任意

システムイベントのライフサイクルステータス。EventCycleStatus パラメーターは、InstanceEventCycleStatus.N パラメーターが指定されていない場合にのみ有効です。有効な値:

  • Scheduled: イベントは実行待ちです。

  • Avoided: イベントは回避されました。

  • Executing: イベントは実行中です。

  • Executed: イベントの実行が完了しました。

  • Canceled: イベントはキャンセルされました。

  • Failed: イベントの実行は失敗した。

  • Inquiring: イベントは問い合わせ状態です。

Executed

EventType

string

任意

システムイベントのタイプ。EventType パラメーターは、InstanceEventType.N パラメーターが指定されていない場合にのみ有効です。有効な値:

  • SystemMaintenance.Reboot: システムメンテナンスによりインスタンスが再起動されます。

  • SystemMaintenance.Redeploy: システムメンテナンスによりインスタンスが再デプロイされます。

  • SystemFailure.Reboot: システム障害によりインスタンスが再起動されます。

  • SystemFailure.Redeploy: システム障害によりインスタンスが再デプロイされます。

  • SystemFailure.Delete: インスタンス作成の失敗によりインスタンスがリリースされます。

  • InstanceFailure.Reboot: インスタンス障害によりインスタンスが再起動されます。

  • InstanceExpiration.Stop: 有効期限切れによりサブスクリプションインスタンスが停止されます。

  • InstanceExpiration.Delete: 有効期限切れによりサブスクリプションインスタンスがリリースされます。

  • AccountUnbalanced.Stop: 支払い遅延により従量課金インスタンスが停止されます。

  • AccountUnbalanced.Delete: 支払い遅延により従量課金インスタンスがリリースされます。

説明

イベントタイプの詳細については、「システムイベントの概要」を参照してください。このパラメーターの値は、ディスクシステムイベントではなく、インスタンスシステムイベントのみを指定できます。

SystemMaintenance.Reboot

NotBefore.Start

string

任意

システムイベントのスケジュールされた実行時間の開始時刻。ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 初期化で時刻を指定します。時刻は協定世界時 (UTC) である必要があります。 ISO 8601

2017-11-30T06:32:31Z

NotBefore.End

string

任意

システムイベントのスケジュールされた実行時間の終了時刻。ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 初期化で時刻を指定します。時刻は協定世界時 (UTC) である必要があります。 ISO 8601

2017-12-01T06:32:31Z

EventPublishTime.Start

string

任意

システムイベントの公開時間の開始時刻。ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 初期化で時刻を指定します。時刻は協定世界時 (UTC) である必要があります。 ISO 8601

2017-11-30T06:32:31Z

EventPublishTime.End

string

任意

システムイベントの公開時間の終了時刻。ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 初期化で時刻を指定します。時刻は協定世界時 (UTC) である必要があります。 ISO 8601

2017-12-01T06:32:31Z

ImpactLevel

string

任意

説明

このパラメーターは使用できません。

null

PageNumber

integer

任意

説明

このパラメーターはまもなく非推奨になります。ページングには MaxResults パラメーターまたは NextToken パラメーターを使用してください。

1

PageSize

integer

任意

説明

このパラメーターはまもなく非推奨になります。ページングには MaxResults パラメーターまたは NextToken パラメーターを使用してください。

10

ResourceType

string

任意

リソースタイプ。有効な値:

  • instance: ECS インスタンス。

  • ddh: 専用ホスト。

  • managedhost: インテリジェントフルマネージドリソースプール内の物理マシン。

デフォルト値: instance。

instance

EventId

array

任意

1 つ以上のシステムイベントの ID。N の有効な値: 1~100。複数の値を繰り返しのリストで指定します。

e-uf64yvznlao4jl2c****

string

任意

1 つ以上のシステムイベントの ID。N の有効な値: 1~100。複数の値を繰り返しのリストで指定します。

e-uf64yvznlao4jl2c****

InstanceEventCycleStatus

array

任意

1 つ以上のシステムイベントのライフサイクルステータス。N の有効な値: 1~7。複数の値を繰り返しのリストで指定します。有効な値:

  • Scheduled: イベントは実行待ちです。

  • Avoided: イベントは回避されました。

  • Executing: イベントは実行中です。

  • Executed: イベントの実行が完了しました。

  • Canceled: イベントはキャンセルされました。

  • Failed: イベントの実行は失敗した。

  • Inquiring: イベントは問い合わせ状態です。

Executed

string

任意

1 つ以上のシステムイベントのライフサイクルステータス。N の有効な値: 1~7。複数の値を繰り返しのリストで指定します。有効な値:

  • Scheduled: イベントは実行待ちです。

  • Avoided: イベントは回避されました。

  • Executing: イベントは実行中です。

  • Executed: イベントの実行が完了しました。

  • Canceled: イベントはキャンセルされました。

  • Failed: イベントの実行は失敗した。

  • Inquiring: イベントは問い合わせ状態です。

Executed

InstanceEventType

array

任意

1 つ以上のシステムイベントのタイプ。N の有効な値: 1~30。複数の値を繰り返しのリストで指定します。有効な値:

  • SystemMaintenance.Reboot: システムメンテナンスによりインスタンスが再起動されます。

  • SystemMaintenance.Redeploy: システムメンテナンスによりインスタンスが再デプロイされます。

  • SystemFailure.Reboot: システム障害によりインスタンスが再起動されます。

  • SystemFailure.Redeploy: システム障害によりインスタンスが再デプロイされます。

  • SystemFailure.Delete: インスタンス作成の失敗によりインスタンスがリリースされます。

  • InstanceFailure.Reboot: インスタンス障害によりインスタンスが再起動されます。

  • InstanceExpiration.Stop: 有効期限切れによりサブスクリプションインスタンスが停止されます。

  • InstanceExpiration.Delete: 有効期限切れによりサブスクリプションインスタンスがリリースされます。

  • AccountUnbalanced.Stop: 支払い遅延により従量課金インスタンスが停止されます。

  • AccountUnbalanced.Delete: 支払い遅延により従量課金インスタンスがリリースされます。

説明

イベントタイプの詳細については、「システムイベントの概要」を参照してください。このパラメーターの値は、ディスクシステムイベントではなく、インスタンスシステムイベントのみを指定できます。

SystemMaintenance.Reboot

string

任意

1 つ以上のシステムイベントのタイプ。N の有効な値: 1~30。複数の値を繰り返しのリストで指定します。有効な値:

  • SystemMaintenance.Reboot: システムメンテナンスによりインスタンスが再起動されます。

  • SystemMaintenance.Redeploy: システムメンテナンスによりインスタンスが再デプロイされます。

  • SystemFailure.Reboot: システム障害によりインスタンスが再起動されます。

  • SystemFailure.Redeploy: システム障害によりインスタンスが再デプロイされます。

  • SystemFailure.Delete: インスタンス作成の失敗によりインスタンスがリリースされます。

  • InstanceFailure.Reboot: インスタンス障害によりインスタンスが再起動されます。

  • InstanceExpiration.Stop: 有効期限切れによりサブスクリプションインスタンスが停止されます。

  • InstanceExpiration.Delete: 有効期限切れによりサブスクリプションインスタンスがリリースされます。

  • AccountUnbalanced.Stop: 支払い遅延により従量課金インスタンスが停止されます。

  • AccountUnbalanced.Delete: 支払い遅延により従量課金インスタンスがリリースされます。

説明

イベントタイプの詳細については、「システムイベントの概要」を参照してください。このパラメーターの値は、ディスクシステムイベントではなく、インスタンスシステムイベントのみを指定できます。

SystemMaintenance.Reboot

ResourceId

array

任意

1 つ以上のリソースの ID。N の有効な値: 1~100。複数の値を繰り返しのリストで指定します。有効な値:

  • ResourceType が instance に設定されている場合、リソース ID は ECS インスタンス ID です。

  • ResourceType が ddh に設定されている場合、リソース ID は専用ホスト ID です。

  • ResourceType が managedhost に設定されている場合、リソース ID はインテリジェントフルマネージドリソースプール内の物理マシン ID です。

このパラメーターを指定しない場合、指定されたリージョン (RegionId) 内の指定されたリソースタイプ (ResourceType) のすべてのリソースのシステムイベントが照会されます。

説明

1 つ以上のリソース ID を指定するには、ResourceId.N パラメーターを使用します。ResourceId.N パラメーターと InstanceId パラメーターの両方を指定した場合、デフォルトでは ResourceId.N パラメーターが優先されます。

i-uf678mass4zvr9n1****

string

任意

1 つ以上のリソースの ID。N の有効な値: 1~100。複数の値を繰り返しのリストで指定します。有効な値:

  • ResourceType が instance に設定されている場合、リソース ID は ECS インスタンス ID です。

  • ResourceType が ddh に設定されている場合、リソース ID は専用ホスト ID です。

  • ResourceType が managedhost に設定されている場合、リソース ID はインテリジェントフルマネージドリソースプール内の物理マシン ID です。

このパラメーターを指定しない場合、指定されたリージョン (RegionId) 内の指定されたリソースタイプ (ResourceType) のすべてのリソースのシステムイベントが照会されます。

説明

1 つ以上のリソース ID を指定するには、ResourceId.N パラメーターを使用します。ResourceId.N パラメーターと InstanceId パラメーターの両方を指定した場合、デフォルトでは ResourceId.N パラメーターが優先されます。

i-uf678mass4zvr9n1****

Tag

array<object>

任意

システムイベントでサポートされているタグのリスト。

object

任意

システムイベントでサポートされているタグのリスト。

Key

string

任意

リソースのタグキー。

TestKey

Value

string

任意

リソースのタグ値。

TestValue

ResourceGroupId

string

任意

リソースが属するリソースグループの ID。

rg-bp67acfmxazb4p****

NextToken

string

任意

クエリトークン。前の API 呼び出しから返された NextToken 値に設定します。

f1c9fa9de5752***

MaxResults

integer

任意

ページング用の 1 ページあたりのエントリの最大値。有効な値: 10~100。

デフォルト値:

  • 指定された値が 0 より大きく 10 未満の場合、デフォルト値は 10 です。

  • 指定された値が 100 より大きい場合、デフォルト値は 100 です。

100

レスポンスフィールド

フィールド

型

説明

例

object

照会されたインスタンスのシステムイベント情報。

PageSize

integer

リクエストで指定された 1 ページあたりのエントリ数。

説明
  • ページングに MaxResults パラメーターと NextToken パラメーターを使用する場合、返される PageSize 値に意味はありません。

  • このパラメーターはまもなく非推奨になります。ページングには NextToken パラメーターと MaxResults パラメーターを使用してください。

10

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

PageNumber

integer

インスタンスイベントリストのページ番号。

説明
  • ページングに MaxResults パラメーターと NextToken パラメーターを使用する場合、返される PageNumber 値に意味はありません。

  • このパラメーターはまもなく非推奨になります。ページングには NextToken パラメーターと MaxResults パラメーターを使用してください。

1

TotalCount

integer

インスタンスイベントの総数。

説明

ページングに MaxResults パラメーターと NextToken パラメーターを使用する場合、返される TotalCount 値に意味はありません。

2

InstanceSystemEventSet

object

InstanceSystemEventType

array<object>

インスタンスの過去のシステムイベントの配列。

array<object>

インスタンスの過去のシステムイベント。

EventId

string

システムイベントの ID。

e-uf64yvznlao4jl2c****

EventPublishTime

string

システムイベントの公開時間。時間は ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時間は協定世界時 (UTC) です。 ISO 8601

2017-11-30T06:32:31Z

EventFinishTime

string

システムイベントの終了時間。時間は ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時間は協定世界時 (UTC) です。 ISO 8601

2017-12-01T06:35:31Z

ResourceType

string

リソースタイプ。有効な値:

  • instance: ECS インスタンス。

  • ddh: 専用ホスト。

  • managedhost: インテリジェントフルマネージドリソースプール内の物理マシン。

instance

ImpactLevel

string

影響レベル。

100

NotBefore

string

システムイベントの予定実行時間。時間は ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時間は協定世界時 (UTC) です。 ISO 8601

2017-12-06T00:00:00Z

InstanceId

string

インスタンス ID

i-uf678mass4zvr9n1****

Reason

string

システムイベントの原因。

System maintenance is scheduled due to ***.

EventType

object

システムイベントタイプ。

Name

string

システムイベントタイプの名前。

InstanceExpiration.Stop

Code

integer

システムイベントタイプのコード。

34

EventCycleStatus

object

システムイベントのライフサイクルステータス。

Name

string

システムイベントステータスの名前。

Executed

Code

integer

システムイベントの状態コード。

0

ExtendedAttribute

object

イベントの拡張属性。

Device

string

ローカルディスクのデバイス名。

/dev/vda

DiskId

string

ローカルディスクの ID。

d-diskid1

InactiveDisks

object

InactiveDisk

array<object>

リリースされたがクリーンアップが必要な非アクティブなクラウドディスクまたはローカルディスクに関する情報のリスト。

object

リリースされたがクリーンアップが必要な非アクティブなクラウドディスクまたはローカルディスクに関する情報。

CreationTime

string

クラウドディスクまたはローカルディスクの作成時間。時間は ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時間は協定世界時 (UTC) です。 ISO 8601

2018-11-30T06:32:31Z

DeviceSize

string

クラウドディスクまたはローカルディスクのサイズ。単位: GiB。

80

DeviceCategory

string

クラウドディスクまたはローカルディスクのカテゴリ。有効な値:

  • cloud: 基本ディスク。

  • cloud_efficiency: Ultra ディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD (エンタープライズ SSD)。

  • local_ssd_pro: I/O 集約型ローカルディスク。

  • local_hdd_pro: スループット集約型ローカルディスク。

  • ephemeral: (廃止済み) ローカルディスク。

  • ephemeral_ssd: (廃止済み) ローカル SSD。

cloud_efficiency

DeviceType

string

クラウドディスクまたはローカルディスクのタイプ。有効な値:

  • system: システムディスク。

  • data: データディスク。

data

ReleaseTime

string

クラウドディスクまたはローカルディスクのリリース時間。時間は ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時間は協定世界時 (UTC) です。 ISO 8601

2019-11-30T06:32:31Z

HostType

string

ホストタイプ。有効な値:

  • ddh: 専用ホスト。

  • managedhost: インテリジェントフルマネージドリソースプール内の物理マシン。

ddh

HostId

string

ホスト ID。

dh-bp1ewce1gk3iwv2****

MigrationOptions

object

MigrationOption

array

インスタンス移行オプション。現在、MigrationOptions (移行計画を使用した移行) のみがサポートされています。

string

インスタンス移行オプション。現在、MigrationPlan (移行計画を使用した移行) のみがサポートされています。

MigrationPlan

OnlineRepairPolicy

string

損傷したクラウドディスクのオンライン修復ポリシー。有効な値: IsolateOnly。損傷したディスクの隔離のみがサポートされ、損傷したディスクの修復はサポートされないことを示します。

IsolateOnly

Rack

string

CloudBox のラック番号。

A01

PunishType

string

処罰タイプ。

ecs_message_alert

PunishDomain

string

セキュリティ違反のあるドメイン名。

1228.test.com

PunishUrl

string

セキュリティ違反のある URL。

http://1228.test.com/1

Code

string

セキュリティ違反のコード。

PR111

CanAccept

string

イベントを処理できるかどうかを示します。

true

ResponseResult

string

イベントの応答結果。有効な値:

  • true: イベントの応答が成功。

  • false: イベントの応答が失敗。

true

MetricValue

string

メトリック値。

18000

MetricName

string

メトリック名。

in_mbps

InitialNotBefore

string

システムイベントの初期予定実行時間。

2026-06-22T00:00:00Z

ReasonCode

string

システムイベントの原因の分類コード。

VPCMigrationEcs

NextToken

string

この呼び出しで返されるクエリトークン。

説明

ページングに MaxResults パラメーターと NextToken パラメーターを使用する際に NextToken 値が返されない場合、返されるデータはそれ以上ありません。

f1c9fa9de5752***

例

成功レスポンス

JSONJSON

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "InstanceSystemEventSet": {
    "InstanceSystemEventType": [
      {
        "EventId": "e-uf64yvznlao4jl2c****",
        "EventPublishTime": "2017-11-30T06:32:31Z",
        "EventFinishTime": "2017-12-01T06:35:31Z",
        "ResourceType": "instance",
        "ImpactLevel": "100",
        "NotBefore": "2017-12-06T00:00:00Z",
        "InstanceId": "i-uf678mass4zvr9n1****",
        "Reason": "System maintenance is scheduled due to ***.",
        "EventType": {
          "Name": "InstanceExpiration.Stop",
          "Code": 34
        },
        "EventCycleStatus": {
          "Name": "Executed",
          "Code": 0
        },
        "ExtendedAttribute": {
          "Device": "/dev/vda",
          "DiskId": "d-diskid1",
          "InactiveDisks": {
            "InactiveDisk": [
              {
                "CreationTime": "2018-11-30T06:32:31Z",
                "DeviceSize": "80",
                "DeviceCategory": "cloud_efficiency",
                "DeviceType": "data",
                "ReleaseTime": "2019-11-30T06:32:31Z"
              }
            ]
          },
          "HostType": "ddh",
          "HostId": "dh-bp1ewce1gk3iwv2****",
          "MigrationOptions": {
            "MigrationOption": [
              "MigrationPlan"
            ]
          },
          "OnlineRepairPolicy": "IsolateOnly",
          "Rack": "A01",
          "PunishType": "ecs_message_alert",
          "PunishDomain": "1228.test.com",
          "PunishUrl": "http://1228.test.com/1",
          "Code": "PR111",
          "CanAccept": "true",
          "ResponseResult": "true",
          "MetricValue": "18000",
          "MetricName": "in_mbps",
          "InitialNotBefore": "2026-06-22T00:00:00Z"
        },
        "ReasonCode": "VPCMigrationEcs"
      }
    ]
  },
  "NextToken": "f1c9fa9de5752***"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

403 InvalidParameter %s
403 EventIdLimitExceeded %s
403 InvalidParameter.TimeEndBeforeStart %s 指定されたパラメーターは無効です。終了時刻が開始時刻より早くなっていないか確認してください。
403 OperationDenied.NotInWhiteList %s この操作は無効です。まずアカウントをホワイトリストに追加してください。
404 MissingParameter %s

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。