すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:DescribeEniMonitorData

    ドキュメントセンター

    Elastic Compute Service:DescribeEniMonitorData

    最終更新日:Sep 20, 2026

    指定された時間範囲内のセカンダリネットワークインターフェイス (ENI) のトラフィック情報を照会します。

    操作説明

    操作の説明

    セカンダリ ENI について照会できるトラフィック情報には、セカンダリ ENI が送受信したパケット数、インバウンドおよびアウトバウンドの内部ネットワークトラフィック、セカンダリ ENI がドロップしたパケット数が含まれます。応答に一部の情報が含まれていない場合、システムが対応する情報の取得に失敗した可能性があります。たとえば、インスタンスが Stopped 状態であるか、セカンダリ ENI がインスタンスにアタッチされておらず有効 (Available) 状態である場合、対応する情報を取得できません。この操作の呼び出し時は、以下の点に注意してください。

    • 一度に返されるデータエントリの最大値は 400 です。(EndTime–StartTime)/Period の値が 400 以下になるようにしてください。つまり、レスポンスパラメーター TotalCount の値は 400 を超えることはできません。超えた場合、InvalidParameter.TooManyDataQueried エラーが返されます。

    • モニタリング情報は過去 30 日以内のみ照会できます。指定する StartTime パラメーターは、現在の時間より 30 日以上前にはできません。

    今すぐお試しください

    この 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:DescribeEniMonitorData

    get

    NetworkInterface。

    acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

    *Instance。

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    EniId

    string

    任意

    セカンダリ ENI の ID。デフォルトでは、指定されたインスタンスにアタッチされているすべてのセカンダリ ENI が照会されます。

    eni-bp19da36d6xdwey****
    RegionId

    string

    必須

    リージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストを取得できます。

    cn-hangzhou
    InstanceId

    string

    必須

    セカンダリ ENI がアタッチされているインスタンスの ID。

    i-bp1a5zr3u7nq9cx****
    StartTime

    string

    必須

    照会する時間範囲の開始時間。時間は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定します。時間は協定世界時 (UTC) でなければなりません。秒 (ss) の値が 00 でない場合、時間は自動的に次の分に切り上げられます。

    2018-05-21T12:19:00Z
    EndTime

    string

    必須

    照会する時間範囲の終了時間。時間は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定します。時間は協定世界時 (UTC) でなければなりません。秒 (ss) の値が 00 でない場合、時間は自動的に次の分に切り上げられます。

    2018-05-21T12:22:00Z
    Period

    integer

    任意

    モニタリングデータを取得する間隔。単位: 秒。有効な値:

    • 60。

    • 600。

    • 3600。

    デフォルト値: 60。

    列挙値:

    • 60 :

      60 秒。

    • 600 :

      600 秒。

    • 3600 :

      3600 秒。

    60

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalCount

    integer

    返されるエントリの総数。

    4
    RequestId

    string

    リクエスト ID

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    MonitorData

    object

    EniMonitorData

    array<object>

    セカンダリ ENI トラフィックの EniMonitorDataType タイプのモニタリングデータのコレクション。

    object

    PacketRx

    string

    セカンダリ ENI が受信した内部ネットワークパケット数。単位: パケット。

    0
    TimeStamp

    string

    モニタリングデータのタイムスタンプ。時間は協定世界時 (UTC) の yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。

    2018-05-21T03:22:00Z
    DropPacketRx

    string

    セカンダリ ENI が受信時にドロップした内部ネットワークパケット数。単位: パケット。

    0
    EniId

    string

    セカンダリ ENI の ID。

    eni-bp19da36d6xdwey****
    DropPacketTx

    string

    セカンダリ ENI が送信時にドロップした内部ネットワークパケット数。単位: パケット。

    0
    PacketTx

    string

    セカンダリ ENI が送信した内部ネットワークパケット数。単位: パケット。

    0
    IntranetTx

    string

    セカンダリ ENI が送信した内部ネットワークデータの平均レート。単位: kB/s。

    0
    IntranetRx

    string

    セカンダリ ENI が受信した内部ネットワークデータの平均レート。単位: kB/s。

    0

    例

    成功レスポンス

    JSONJSON

    {
  "TotalCount": 4,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "MonitorData": {
    "EniMonitorData": [
      {
        "PacketRx": "0",
        "TimeStamp": "2018-05-21T03:22:00Z",
        "DropPacketRx": "0",
        "EniId": "eni-bp19da36d6xdwey****",
        "DropPacketTx": "0",
        "PacketTx": "0",
        "IntranetTx": "0",
        "IntranetRx": "0"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidEniId.NotFound The specified ENI ID does not exist. 指定されたインスタンスは無効です。
    403 InvalidStartTime.Malformed The specified parameter "StartTime" is not valid.
    403 InvalidEndTime.Malformed The specified parameter "EndTime" is not valid.
    403 InvalidPeriod.ValueNotSupported The specified parameter "Period" is not valid.
    403 InvalidStartTime.TooEarly The specified parameter "StartTime" is too early.
    403 InvalidParameter.TooManyDataQueried Too many data queried.
    403 Throttling Request was denied due to request throttling.
    403 InvalidInstanceType.NotSupportCredit The InstanceType of the specified instance does not support credit.
    403 InvalidParameter.EndTime The specified parameter EndTime is earlier than StartTime.
    4003 InvalidParam.Malformed The specified parameter "EniId" and "InstanceId" are not valid
    404 InvalidDiskId.NotFound The DiskId provided does not exist in our records. 指定されたディスクが存在しません。ディスク ID が正しいかどうかを確認してください。
    404 InvalidEcsId.NotFound The specified instance ID is invalid. 指定されたインスタンスは無効です。

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

    変更履歴

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