调用PutHybridMonitorMetricData接口将指定监控数据上报至企业云监控的指定指标仓库中。
前提条件
请确保您已开通企业云监控。具体操作，请参见开通企业云监控。
使用限制
单次上报监控数据小于等于1 MB。
使用说明
本文将提供一个示例，将监控指标CPU_Usage的监控数据上报至企业云监控的指标仓库default-aliyun中。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | PutHybridMonitorMetricData |
要执行的操作，取值：PutHybridMonitorMetricData。 |
| Namespace | String | 是 | default-aliyun |
指标仓库名称。 关于如何获取指标仓库名称，请参见DescribeHybridMonitorNamespaceList。 |
| MetricList.N.Name | String | 是 | CPU_Usage |
监控指标名称。 N的取值范围：1~100。 格式：由大写字母、小写字母、数字和下划线（_）组成。开头必须为大写字母或小写字母。 |
| MetricList.N.Labels.N.Key | String | 否 | IP |
监控指标的标签键。 N的取值范围：1~100。 格式：由大写字母、小写字母、数字和下划线（_）组成。开头必须为大写字母、小写字母或下划线（_）。 说明 Key和Value必须同时设置。
|
| MetricList.N.Labels.N.Value | String | 否 | 192.168.XX.XX |
监控指标的标签值。 N的取值范围：1~100。 说明 Key和Value必须同时设置。
|
| MetricList.N.Value | String | 是 | 90 |
监控指标的取值。 N的取值范围：1~100。 格式：整数或浮点数。 |
| MetricList.N.TS | Long | 否 | 1640776119473 |
监控数据上报的时间戳。 N的取值范围：1~100。 单位：毫秒。默认值为当前时间。 |
关于公共请求参数的详情，请参见公共参数。
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | 200 |
状态码。 说明 200表示成功。
|
| RequestId | String | 5DB1CBCA-D14A-55FA-814F-B4DBD9735F68 |
请求ID。 |
| ErrorDetail | Array of detail |
错误参数的详情。 如果您设置的请求参数不符合要求，则会显示错误参数的详情。 |
|
| Index | Long | 0 |
错误信息在数组中的位置。 |
| ErrorMessage | String | label name :123 not match [a-zA-Z_][a-zA-Z0-9_]* |
错误参数的提示信息。 |
示例
请求示例
http(s)://[Endpoint]/?Action=PutHybridMonitorMetricData
&MetricList.1.Name=CPU_Usage
&MetricList.1.Value=90
&Namespace=default-aliyun
&<公共请求参数>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<PutHybridMonitorMetricDataResponse>
<RequestId>5DB1CBCA-D14A-55FA-814F-B4DBD9735F68</RequestId>
<Code>200</Code>
</PutHybridMonitorMetricDataResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "5DB1CBCA-D14A-55FA-814F-B4DBD9735F68",
"Code" : "200"
}错误码
访问错误中心查看更多错误码。