DescribeMultiContainerGroupMetric - 查询多个ECI实例的监控数据

调用DescribeContainerGroupMetric查询一个ECI实例的监控数据。

接口说明

  • 仅返回每个 ECI 实例最新的一条监控信息。
  • 仅支持查询创建时间晚于北京时间 2019 年 04 月 03 日 15 时的 ECI 实例的监控数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
eci:DescribeMultiContainerGroupMetricget
*containergroup
acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId}
  • eci:tag

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
ContainerGroupIdsstring

ECI 实例 ID,即容器组 ID。格式为 JSON 数组,一次最多支持 20 个 ID。

["eci-2zegym1qhbmdfr1s****","eci-2ze39w5svzj5ic34****"]
ResourceGroupIdstring

实例所属的资源组 ID。

rg-acfmzw2jz2z****
MetricTypestring

监控信息类型。目前仅支持配置为 summary,表示返回 Records。

summary

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID,唯一标识。

B8756BA0-6452-419C-9727-37A6209C85E0
MonitorDatasarray<object>

监控信息集合。

Recordobject
Recordsarray<object>

监控数据详情。

PodStatobject
Networkobject

网络数据。

Interfacesarray<object>

网卡数据。

Interfaceobject
RxErrorslong

累计接收错误数。

0
TxDropslong

累计发送丢包数。

0
TxByteslong

累计发送字节数。

1381805699
RxPacketslong

累计接收包数量。

4800583
TxPacketslong

累计发送包数量。

5158427
Namestring

网卡名称。

eth0
TxErrorslong

累计发送错误数。

0
RxByteslong

累计接收字节数。

505001954
RxDropslong

累计接收丢包数。

0
CPUobject

CPU 数据。

UsageNanoCoreslong

CPU 在采样窗口内的使用量(纳秒)。

0
Limitlong

CPU 使用上限(CPU 核数*1000)。

2000
UsageCoreNanoSecondslong

CPU 历史使用总量。

70769883
Loadlong

最近 10 秒的平均负载情况。

0
Diskarray<object>

磁盘数据。

DiskStatsobject
WriteByteslong

磁盘写入的数据量,单位为 Byte。

1375109120
Devicestring

磁盘名称。

/dev/vda
WriteIolong

该参数暂未开放使用。

123
ReadByteslong

磁盘读取的数据量,单位为 Byte。

210714112
ReadIolong

该参数暂未开放使用。

123
Timestampstring

监控数据对应的统计时间。格式为 RFC3339 时间格式。

2019-12-19T02:31:54Z
Memoryobject

内存数据。

Rsslong

常驻内存集,即实际使用的物理内存。

1593344
UsageByteslong

已使用内存。

11153408
WorkingSetlong

当前内存工作集使用量。

5521408
AvailableByteslong

可用内存。

4289445888
Cachelong

缓存。

7028736
Containersarray<object>

容器的监控数据详情。

Containerobject
CPUobject

容器的 CPU 数据。

UsageNanoCoreslong

CPU 在采样窗口内的使用量(纳秒)。

0
Limitlong

CPU 使用上限(CPU 核数*1000)。

321234
UsageCoreNanoSecondslong

CPU 历史使用总量。

40876694
Loadlong

最近 10 秒的平均负载情况。

12341
Memoryobject

容器的内存数据。

Rsslong

常驻内存集,即实际使用的物理内存。

9289728
UsageByteslong

已使用内存。

9289728
WorkingSetlong

当前内存工作集使用量。

9289728
AvailableByteslong

可用内存。

4285091840
Cachelong

缓存。

9289728
Namestring

名称。

test1
Filesystemarray<object>

文件系统分区数据。

FsStatsobject
Capacitylong

空间总量。

41610981376
Availablelong

可用空间。

35319836672
FsNamestring

分区名称。

/dev/root
Usagelong

已使用空间。

4368744448
ContainerGroupIdstring

实例 ID,即容器组 ID。

eci-bp15oolgorelvhfb****

示例

正常返回示例

JSON格式

{
  "RequestId": "B8756BA0-6452-419C-9727-37A6209C85E0",
  "MonitorDatas": [
    {
      "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,
              "Device": "/dev/vda",
              "WriteIo": 123,
              "ReadBytes": 210714112,
              "ReadIo": 123
            }
          ],
          "Timestamp": "2019-12-19T02:31:54Z",
          "Memory": {
            "Rss": 1593344,
            "UsageBytes": 11153408,
            "WorkingSet": 5521408,
            "AvailableBytes": 4289445888,
            "Cache": 7028736
          },
          "Containers": [
            {
              "CPU": {
                "UsageNanoCores": 0,
                "Limit": 321234,
                "UsageCoreNanoSeconds": 40876694,
                "Load": 12341
              },
              "Memory": {
                "Rss": 9289728,
                "UsageBytes": 9289728,
                "WorkingSet": 9289728,
                "AvailableBytes": 4285091840,
                "Cache": 9289728
              },
              "Name": "test1"
            }
          ],
          "Filesystem": [
            {
              "Capacity": 41610981376,
              "Available": 35319836672,
              "FsName": "/dev/root",
              "Usage": 4368744448
            }
          ]
        }
      ],
      "ContainerGroupId": "eci-bp15oolgorelvhfb****"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-09-19API 内部配置变更,不影响调用查看变更详情