All Products
Search
Document Center

CloudMonitor:PutHybridMonitorMetricData

Last Updated:Mar 18, 2024

Imports the monitoring data of a metric to a namespace of Hybrid Cloud Monitoring.

Operation description

Prerequisites

Hybrid Cloud Monitoring is activated. For more information, see Activate Hybrid Cloud Monitoring.

Limits

The size of the monitoring data that you import at a time must be less than or equal to 1 MB.

Description

This topic provides an example on how to import the monitoring data of the CPU_Usage metric to the default-aliyun namespace of Hybrid Cloud Monitoring.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
NamespacestringYes

The name of the namespace.

For information about how to obtain the name of a namespace, see DescribeHybridMonitorNamespaceList .

default-aliyun
MetricListobject []Yes

The monitoring data.

Valid values of N: 1 to 100.

NamestringYes

The metric name.

Valid values of N: 1 to 100.

The name can contain letters, digits, and underscores (_). The name must start with a letter.

CPU_Usage
Labelsobject []No

The tags of the metric.

Valid values of N: 1 to 100.

KeystringNo

The tag key of the metric.

Valid values of N: 1 to 100.

The key can contain letters, digits, and underscores (_). The key must start with a letter or an underscore (_).

Note You must specify both the Key and Value parameters.
IP
ValuestringNo

The tag value of the metric.

Valid values of N: 1 to 100.

Note You must specify both the Key and Value parameters.
192.168.XX.XX
ValuestringYes

The value of the metric.

Valid values of N: 1 to 100.

The value must be an integer or a floating-point number.

90
TSlongNo

The time when the monitoring data is imported. The value is a timestamp.

Valid values of N: 1 to 100.

Unit: milliseconds. By default, the current time is used.

1640776119473

For more information about common request parameters, see Common parameters.

Response parameters

ParameterTypeDescriptionExample
object

None.

Codestring

The HTTP status code.

Note The status code 200 indicates that the request was successful.
200
RequestIdstring

The request ID.

5DB1CBCA-D14A-55FA-814F-B4DBD9735F68
ErrorDetailobject []

The details of invalid parameters.

If a request parameter is invalid, the details of the invalid parameter are returned.

Indexlong

The position of the error message in the array.

0
ErrorMessagestring

The error message of the invalid parameter.

label name :123 not match [a-zA-Z_][a-zA-Z0-9_]*

Examples

Sample success responses

JSONformat

{
  "Code": "200",
  "RequestId": "5DB1CBCA-D14A-55FA-814F-B4DBD9735F68",
  "ErrorDetail": [
    {
      "Index": 0,
      "ErrorMessage": "label name :123 not match [a-zA-Z_][a-zA-Z0-9_]*"
    }
  ]
}

Error codes

HTTP status codeError codeError message
400%s%s
500InternalError%s

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history