調用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} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 |
返回參數
示例
正常返回示例
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"
}
]
}
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。