查询指标趋势 - ListMetricsTrend
功能介绍
查询指标趋势。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/statistics/metrics/trend
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
dim | 否 | String | 指标维度 | 目前最大支持3个维度，必须从0开始；维度格式为dim.{i}=key,value，key的最大长度32，value的最大长度为256。 单维度：dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d 多维度：dim.0=key,value&dim.1=key,value。 |
start_time | 是 | String | 开始时间。 |
end_time | 是 | String | 结束时间。 |
metric_names | 是 | Array of strings | 指标名称列表。 |
period | 否 | String | 数据周期 | MIN - 分钟级 5MIN - 5分钟级 DAY - 天级数据 HOUR - 小时级数据。 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
[数组元素] | Array of MetricsWithTime objects | 查询指标趋势响应。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码。 |
error_msg | String | 错误描述。 |
状态码：401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码。 |
error_msg | String | 错误描述。 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码。 |
error_msg | String | 错误描述。 |
请求示例
无
响应示例
状态码：200
响应成功。
[ {
"time" : "string",
"metrics" : [ {
"metric_name" : "desktop_state",
"metric_value" : 10
} ]
} ] 状态码
状态码 | 描述 |
|---|---|
200 | 响应成功。 |
400 | 客户端请求有误。 |
401 | 鉴权失败。 |
500 | 内部错误。 |
错误码
请参见错误码。
