全部產品
Search

搜尋本產品

    Elastic Container Instance：DescribeContainerGroupMetric - 查詢一個ECI執行個體的監控資料

    文件中心

    Elastic Container Instance：DescribeContainerGroupMetric - 查詢一個ECI執行個體的監控資料

    更新時間：Oct 17, 2025

    調用DescribeContainerGroupMetric查詢一個ECI執行個體的監控資料。

    介面說明

    • 最多支援返回 50 條監控資料，超出 50 條將會報錯。

    • 僅支援分別查詢 5 分鐘以內的即時資料，或者 5 分鐘之前的歷史資料。如果查詢時間段超出了目前時間點，預設只查詢 5 分鐘之前的歷史資料。

    • 僅支援查詢建立時間晚於北京時間 2019 年 04 月 03 日 15 點的 ECI 執行個體的監控資料。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    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 年 03 月 12 號上午 9 點整可以表示為 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 分鐘的監控資料，預設彙總周期為 15S，傳入的 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>

    網卡資料。

    object

    RxErrors

    integer

    累計接收錯誤數。

    0
    TxDrops

    integer

    累計發送丟包數。

    0
    TxBytes

    integer

    累計發送位元組數。

    1381805699
    RxPackets

    integer

    累計接收包數量。

    4800583
    TxPackets

    integer

    累計發送包數量。

    5158427
    Name

    string

    網卡名稱。

    eth0
    TxErrors

    integer

    累計發送錯誤數。

    0
    RxBytes

    integer

    累計接收位元組數。

    505001954
    RxDrops

    integer

    累計接收丟包數。

    0
    CPU

    object

    CPU 資料。

    UsageNanoCores

    integer

    CPU 在採樣視窗內的使用量（納秒）。

    0
    Limit

    integer

    CPU 使用上限（CPU 核心數*1000）。

    2000
    UsageCoreNanoSeconds

    integer

    CPU 歷史使用總量。

    70769883
    Load

    integer

    最近 10 秒的平均負載情況。

    0
    Disk

    array<object>

    磁碟資料。

    object

    WriteBytes

    integer

    磁碟寫入的資料量，單位為 Byte。

    1375109120
    WriteIO

    integer

    該參數暫未開放使用。

    123
    Device

    string

    磁碟名稱。

    /dev/vda
    ReadIO

    integer

    該參數暫未開放使用。

    123
    ReadBytes

    integer

    磁碟讀取的資料量，單位為 Byte。

    210714112
    Timestamp

    string

    每條監控資料對應的統計時間。格式為 RFC3339 時間格式。

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

    object

    記憶體資料。

    Rss

    integer

    常駐記憶體集，即實際使用的實體記憶體。

    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 使用上限（CPU 核心數*1000）。

    1024
    UsageCoreNanoSeconds

    integer

    CPU 歷史使用總量。

    40876694
    Load

    integer

    最近 10 秒的平均負載情況。

    0
    Memory

    object

    容器的記憶體資料。

    Rss

    integer

    常駐記憶體集，即實際使用的實體記憶體。

    9289728
    UsageBytes

    integer

    已使用記憶體。

    9289728
    WorkingSet

    integer

    當前記憶體工作集使用量。

    9289728
    AvailableBytes

    integer

    可用記憶體。

    4285091840
    Cache

    integer

    緩衝。

    9289728
    Name

    string

    容器名稱。

    u1

    樣本

    正常返回樣本

    JSON格式

    {
  "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"
        }
      ]
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。