すべてのプロダクト
Search

このプロダクト

    :DescribeContainerGroupMetric

    ドキュメントセンター

    :DescribeContainerGroupMetric

    最終更新日:Oct 17, 2025

    Elastic Container Instance (ECI) のモニタリングデータを照会します。

    操作説明

    • この操作では、最大 50 件のモニタリングデータレコードを返すことができます。 レコード数が 50 を超えると、エラーが返されます。

    • 過去 5 分以内のリアルタイムデータ、または 5 分以上前の既存データを照会できます。 指定された時間範囲が現在時刻を超える場合、この操作ではデフォルトで既存データのみが照会されます。

    • モニタリングデータは、2019 年 4 月 3 日 15:00 (UTC + 08:00) 以降に作成された ECI インスタンスでのみ利用可能です。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eci:DescribeContainerGroupMetric

    get

    *containergroup

    acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId}
    • eci:tag
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    ContainerGroupId

    string

    必須

    ECI インスタンスの ID。 これはコンテナグループ ID です。

    eci-bp17da5olmkuagfr****
    StartTime

    string

    任意

    クエリする時間範囲の開始時刻。 値は過去 30 日以内でなければなりません。 デフォルト値は EndTime の値の 5 分前です。

    時間は RFC3339 フォーマットです。 たとえば、2019 年 3 月 12 日 09:00:00 (UTC + 08:00) は、2019-03-12T09:00:00.000+08:00 または 2019-03-12T01:00:00.000Z と表すことができます。

    2019-03-12T01:00:00.000Z
    EndTime

    string

    任意

    クエリする時間範囲の終了時刻。 デフォルト値は現在時刻です。

    時間は RFC3339 フォーマットです。

    2019-09-12T01:05:00.000Z

    Period

    string

    任意

    集計期間。 単位: 秒。 有効値: 15、30、60、600。 デフォルト値: 60。

    説明

    StartTime と EndTime を設定しない場合、過去 5 分間のモニタリングデータが照会されます。 デフォルトの集計期間は 15 秒で、Period パラメーターは無視されます。

    15

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストの一意の ID。

    D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC
    ContainerGroupId

    string

    ECI インスタンスの ID。 これはコンテナグループ ID です。

    eci-bp1dqpye03ke5s6p****
    Records

    array<object>

    ECI インスタンスのモニタリングデータ。

    array<object>

    Network

    object

    ネットワークデータ。

    Interfaces

    array<object>

    NIC (ネットワークインターフェイスカード) のデータ。

    object

    RxErrors

    integer

    受信したエラーパケットの総数。

    0
    TxDrops

    integer

    送信時にドロップされたパケットの総数。

    0
    TxBytes

    integer

    送信された合計バイト数。

    1381805699
    RxPackets

    integer

    受信したパケットの総数。

    4800583
    TxPackets

    integer

    送信したパケットの総数。

    5158427
    Name

    string

    NIC の名前。

    eth0
    TxErrors

    integer

    送信したエラーパケットの総数。

    0
    RxBytes

    integer

    受信した合計バイト数。

    505001954
    RxDrops

    integer

    受信時にドロップされたパケットの総数。

    0
    CPU

    object

    CPU データ。

    UsageNanoCores

    integer

    サンプリングウィンドウ内の CPU 使用量 (ナノコア単位)。

    0
    Limit

    integer

    CPU 制限。 vCPU 数 × 1,000 として計算されます。

    2000
    UsageCoreNanoSeconds

    integer

    累積 CPU 使用量 (コア-ナノ秒単位)。

    70769883
    Load

    integer

    過去 10 秒間の平均負荷。

    0
    Disk

    array<object>

    ディスクデータ。

    object

    WriteBytes

    integer

    ディスクに書き込まれたデータ量 (バイト単位)。

    1375109120
    WriteIO

    integer

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

    123
    Device

    string

    ディスクの名前。

    /dev/vda
    ReadIO

    integer

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

    123
    ReadBytes

    integer

    ディスクから読み取られたデータ量 (バイト単位)。

    210714112
    Timestamp

    string

    モニタリングデータが収集された時刻。 時間は RFC3339 フォーマットです。

    2021-08-25T16:22:00.000+08:00
    Memory

    object

    メモリデータ。

    Rss

    integer

    常駐セットサイズ (RSS)。 これは、使用中の物理メモリの量です。

    9289728
    UsageBytes

    integer

    メモリ使用量 (バイト単位)。

    9289728
    WorkingSet

    integer

    ワーキングセットサイズ (バイト単位)。

    9289728
    AvailableBytes

    integer

    利用可能なメモリ (バイト単位)。

    4285091840
    Cache

    integer

    キャッシュ使用量 (バイト単位)。

    9289728
    Filesystem

    array<object>

    ファイルシステムパーティションのデータ。

    object

    Capacity

    integer

    合計ストレージ容量。

    41610981376
    Available

    integer

    利用可能なストレージ容量。

    35319836672
    FsName

    string

    パーティションの名前。

    /dev/root
    Usage

    integer

    使用済みストレージ容量。

    4368744448
    Category

    string

    パーティションのタイプ。 有効値:

    • System

    • Volume

    • Other

    System
    Containers

    array<object>

    コンテナーのモニタリングデータ。

    array<object>

    CPU

    object

    コンテナーの CPU データ。

    UsageNanoCores

    integer

    サンプリングウィンドウ内の CPU 使用量 (ナノコア単位)。

    0
    Limit

    integer

    CPU 制限。 vCPU 数 × 1,000 として計算されます。

    1024
    UsageCoreNanoSeconds

    integer

    累積 CPU 使用量 (コア-ナノ秒単位)。

    40876694
    Load

    integer

    過去 10 秒間の平均負荷。

    0
    Memory

    object

    コンテナーのメモリデータ。

    Rss

    integer

    常駐セットサイズ (RSS)。 これは、使用中の物理メモリの量です。

    9289728
    UsageBytes

    integer

    メモリ使用量 (バイト単位)。

    9289728
    WorkingSet

    integer

    ワーキングセットサイズ (バイト単位)。

    9289728
    AvailableBytes

    integer

    利用可能なメモリ (バイト単位)。

    4285091840
    Cache

    integer

    キャッシュ使用量 (バイト単位)。

    9289728
    Name

    string

    コンテナーの名前。

    u1

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC",
  "ContainerGroupId": "eci-bp1dqpye03ke5s6p****",
  "Records": [
    {
      "Network": {
        "Interfaces": [
          {
            "RxErrors": 0,
            "TxDrops": 0,
            "TxBytes": 1381805699,
            "RxPackets": 4800583,
            "TxPackets": 5158427,
            "Name": "eth0",
            "TxErrors": 0,
            "RxBytes": 505001954,
            "RxDrops": 0
          }
        ]
      },
      "CPU": {
        "UsageNanoCores": 0,
        "Limit": 2000,
        "UsageCoreNanoSeconds": 70769883,
        "Load": 0
      },
      "Disk": [
        {
          "WriteBytes": 1375109120,
          "WriteIO": 123,
          "Device": "/dev/vda",
          "ReadIO": 123,
          "ReadBytes": 210714112
        }
      ],
      "Timestamp": "2021-08-25T16:22:00.000+08:00",
      "Memory": {
        "Rss": 9289728,
        "UsageBytes": 9289728,
        "WorkingSet": 9289728,
        "AvailableBytes": 4285091840,
        "Cache": 9289728
      },
      "Filesystem": [
        {
          "Capacity": 41610981376,
          "Available": 35319836672,
          "FsName": "/dev/root",
          "Usage": 4368744448,
          "Category": "System"
        }
      ],
      "Containers": [
        {
          "CPU": {
            "UsageNanoCores": 0,
            "Limit": 1024,
            "UsageCoreNanoSeconds": 40876694,
            "Load": 0
          },
          "Memory": {
            "Rss": 9289728,
            "UsageBytes": 9289728,
            "WorkingSet": 9289728,
            "AvailableBytes": 4285091840,
            "Cache": 9289728
          },
          "Name": "u1"
        }
      ]
    }
  ]
}

    エラーコード

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

    変更履歴

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