すべてのプロダクト
Search

このプロダクト

    :DescribeEvents

    ドキュメントセンター

    :DescribeEvents

    最終更新日:Apr 01, 2026

    ディスクに関する脅威イベントを照会します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ebs:DescribeEvents

    none

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。EBS レンズがサポートされているリージョンの一覧を照会するには、DescribeRegions を呼び出します。

    cn-hangzhou
    EventName

    string

    任意

    イベント名。有効な値は以下のとおりです。

    • NoSnapshot: データ保護

    • BurstIOTriggered: バースト I/O

    • CostOptimizationNeeded: コスト最適化

    • DiskSpecNotMatchedWithInstance: ディスク仕様がインスタンスタイプと一致していません。

    • DiskIONo4kAligned: 読み取り/書き込み操作が 4K アライメントされていません。

    • DiskIOHang: ディスクで I/O 一部サービス停止イベントが発生しました。

    • InstanceIOPSExceedInstanceMaxLimit: インスタンスの IOPS が上限に達しました。

    • InstanceBPSExceedInstanceMaxLimit: インスタンスの BPS が上限に達しました。

    • DiskIOPSExceedInstanceMaxLimit: ディスクの IOPS がインスタンスの上限に達しました。

    • DiskBPSExceedInstanceMaxLimit: ディスクの BPS がインスタンスの上限に達しました。

    • DiskIOPSExceedDiskMaxLimit: ディスクの IOPS がディスクの上限に達しました。

    • DiskBPSExceedDiskMaxLimit: ディスクの BPS がディスクの上限に達しました。

    DiskIOHang
    ResourceId

    string

    任意

    リソース ID。

    d-bp67acfmxazb4p****
    ResourceType

    string

    任意

    リソースタイプ。有効な値は以下のとおりです。

    • disk: ディスク

    disk
    Status

    string

    任意

    イベントステータス。有効な値は以下のとおりです。

    • WillExecute: 処理待ち

    • Executing: 処理中

    • Executed: 処理済み

    • Ignore: 無視

    • Expired: 有効期限切れ

    • Deleted: 削除済み

    WillExecute
    StartTime

    string

    任意

    照会対象の期間の開始時刻。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ）で指定し、UTC 時間とする必要があります。

    2023-06-01T03:00:00Z
    EndTime

    string

    任意

    照会対象の期間の終了時刻。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ）で指定し、UTC 時間とする必要があります。

    2023-06-01T04:00:00Z
    MaxResults

    integer

    任意

    1 ページあたりに返す最大エントリ数。このパラメーターを指定する場合は、ページングクエリを実行するために NextToken パラメーターと併用する必要があります。

    有効な値：1～100。

    デフォルト値：10。

    10
    NextToken

    string

    任意

    照会トークン。前回の API 呼び出しで返された NextToken の値を設定します。

    AAAAAdDWBF2****
    EventLevel

    string

    任意

    イベントレベル。有効な値は以下のとおりです。

    • INFO: 通知

    • WARN: 警告

    • CRITICAL: 致命的

    WARN

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ

    RequestId

    string

    リクエスト ID

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    TotalCount

    integer

    ページングクエリで返されるエントリの合計数

    1
    NextToken

    string

    次の照会に使用するトークン。このパラメーターが空の場合、すべての結果が返されています。

    AAAAAdDWBF2****
    ResourceEvents

    array<object>

    イベントのリスト

    object

    EventType

    string

    イベントタイプ。可能な値は以下のとおりです。

    1. Notification

    2. SystemException

    3. Alert

    Alert
    EventName

    string

    イベント名。可能な値は以下のとおりです。

    • NoSnapshot: データ保護

    • BurstIOTriggered: バースト I/O

    • CostOptimizationNeeded: コスト最適化

    • DiskSpecNotMatchedWithInstance: ディスク仕様がインスタンスタイプと一致していません。

    • DiskIONo4kAligned: 読み取り/書き込み操作が 4K アライメントされていません。

    • DiskIOHang: ディスクで I/O 一部サービス停止イベントが発生しました。

    • InstanceIOPSExceedInstanceMaxLimit: インスタンスの IOPS が上限に達しました。

    • InstanceBPSExceedInstanceMaxLimit: インスタンスの BPS が上限に達しました。

    • DiskIOPSExceedInstanceMaxLimit: ディスクの IOPS がインスタンスの上限に達しました。

    • DiskBPSExceedInstanceMaxLimit: ディスクの BPS がインスタンスの上限に達しました。

    • DiskIOPSExceedDiskMaxLimit: ディスクの IOPS がディスクの上限に達しました。

    • DiskBPSExceedDiskMaxLimit: ディスクの BPS がディスクの上限に達しました。

    DiskIOHang
    ResourceId

    string

    リソース ID。

    d-bp67acfmxazb4p****

    ResourceType

    string

    リソースタイプ。

    disk
    Status

    string

    イベントステータス。可能な値は以下のとおりです。

    1. WillExecute: 処理待ち

    2. Executing: 処理中

    3. Executed: 処理済み

    4. Ignore: 無視

    5. Expired: 有効期限切れ

    6. Deleted: 削除済み

    WillExecute
    StartTime

    string

    イベントの開始時刻。この値はミリ秒単位の UNIX タイムスタンプです。

    1684204822000
    Description

    string

    イベントの説明。

    可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。
    RecommendAction

    string

    イベント発生後の推奨アクション。可能な値は以下のとおりです。

    • ModifyDiskSpec: ディスクのスペックアップまたはスペックダウン

    • CreateSnapshot: スナップショットの作成

    • ResizeDisk: ディスクのスケールアウト

    • AdjustProvision: プロビジョニングされたパフォーマンスの調整

    • ModifyInstanceSpec: インスタンスのスペックアップまたはスペックダウン

    AdjustProvision
    RecommendParams

    string

    推奨アクションのパラメーター。

    4296
    EventLevel

    string

    イベントレベル。可能な値は以下のとおりです。

    1. INFO

    2. WARN

    3. CRITICAL

    INFO
    EndTime

    string

    イベントの終了時刻。この値はミリ秒単位の UNIX タイムスタンプです。

    1679538083000
    ExtraAttributes

    string

    追加属性。含まれる可能性のあるフィールドは以下のとおりです。

    • EcsInstanceId: ディスクがアタッチされている ECS インスタンスの ID

    • Adapter: ディスクのマウントポイント

    {\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 1,
  "NextToken": "AAAAAdDWBF2****",
  "ResourceEvents": [
    {
      "EventType": "Alert",
      "EventName": "DiskIOHang",
      "ResourceId": "d-bp67acfmxazb4p****\n",
      "ResourceType": "disk",
      "Status": "WillExecute",
      "StartTime": "1684204822000",
      "Description": "可通过购买4296预配置IOPS以获得成本优化，根据您过往7天使用情况，预计成本可以下降16%。",
      "RecommendAction": "AdjustProvision",
      "RecommendParams": "4296",
      "EventLevel": "INFO",
      "EndTime": "1679538083000",
      "ExtraAttributes": "{\\\"EcsInstanceId\\\":\\\"i-uf6dkn9qpcw6y94g7ag7\\\",\\\"Adapter\\\":\\\"hda\\\"}"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 App.NumberExceed The number of apps exceeded.
    400 DocumentConvertFailed.ExceedFileSizeLimit The conversion has been failed, exceed file size limit. 日文说明1
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    400 IdempotentParameterMismatch The specified parameter has changed while using an already used clientToken.
    400 InvalidDiskSize.NotSupported The specified parameter size is not valid.
    400 InvalidParameter The parameter %s is invalid.
    400 InvalidParameter.Conflict The specified parameter %s and %s are not blank at the same time.
    400 InvalidParameter.EndTime The specified parameter EndTime is earlier than StartTime.
    400 InvalidParameter.Format Specified parameter format is not valid. 日文说明
    400 InvalidParameter.TooManyDataQueried Too many data queried.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    403 AliCroup2CloudUserCannotBuyNotInnerCommodity There is no group cloud commodity label, and users within the group are not allowed to purchase. 日文说明1
    403 Forbidden User is not authorized to operate.
    403 Forbidden.Action User is not authorized to operate this action.
    403 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
    403 InvalidDiskCategory.NotSupported The specified disk category is not supported.
    404 InvalidApi.NotFound Specified api is not found, please check your url and method.
    404 NoSuchResource The specified resource does not exist.
    504 RequestTimeout The request is timeout, please try again later.

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

    変更履歴

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