調用PutCustomMetric接口上報自定義監控數據。
接口說明
說明
推薦您使用企業云監控中的接口 PutHybridMonitorMetricData 。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| cms:PutCustomMetric | create |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| MetricList | array<object> | 是 | 監控數據列表。 | |
| object | 是 | |||
| Type | string | 是 | 上報數值類型。N 的取值范圍：1~21。取值：
說明
當上報聚合數據時，建議周期為 60 秒和 300 秒的數據均上報，否則無法正常查詢跨度大于 7 天的監控數據。
| 0 |
| MetricName | string | 是 | 監控項名稱。N 的取值范圍：1~21。詳情請參見云服務監控項。 | cpu_total |
| Time | string | 否 | 指標發生的時間。N 的取值范圍：1~21。支持以下兩種類型：
| 1508136760000 |
| GroupId | string | 是 | 應用分組 ID。N 的取值范圍：1~21。 說明
如果監控項不屬于任何應用分組， 則輸入 0。
| 12345 |
| Values | string | 是 | 指標值集合。N 的取值范圍：1~21。 說明
如果上報數值的類型為 0，則上報的是原始值，云監控會按周期將原始值聚合為多個值，例如：最大、計數、求和等。
| {"value":10.5} |
| Dimensions | string | 是 | 維度 Map，用于查詢指定資源的監控數據。N 的取值范圍：1~21。 格式：key-value 鍵值對形式的集合，常用的 key-value 集合為： Key 和 Value 的長度為 1~64 個字符，超過 64 個字符時截取前 64 個。 Key 和 Value 的取值可包含英文字母、數字、點號（.）、短劃線（-）、下劃線（_）、正斜線（/）和反斜線（\）。 說明
Dimensions 傳入時需要使用 JSON 字符串表示該 Map 對象，必須按順序傳入。
| {"sampleName1":"value1","sampleName2":"value2"} |
| Period | string | 否 | 聚合周期。N 的取值范圍：1~21。單位：秒，取值：60 或 300。 說明
如果上報數值的類型為 1，則需要設置該參數。
| 60 |
返回參數
示例
正常返回示例
JSON格式
{
"Code": "200",
"Message": "The request has failed due to a temporary failure of the server.",
"RequestId": "05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 |
|---|---|---|
| 400 | %s | %s |
| 500 | InternalError | %s |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史