获取多节点单指标数据 - ObtainDataOfSingleMetricOnMultipleNodes
功能介绍
获取多节点单指标数据。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
das::showCloudDBAInfo
read
-
-
-
-
URI
POST /v3/{project_id}/multi-nodes/single-metric
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
metric_name |
是 |
String |
参数解释: 指标名称。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
|
start_at |
是 |
Long |
参数解释: 开始时间。 约束限制: Unix timestamp,单位:毫秒。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
|
end_at |
是 |
Long |
参数解释: 结束时间。 约束限制: Unix timestamp,单位:毫秒。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
|
instance_infos |
是 |
Array of 表3 objects |
参数解释: 实例信息列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
datastore_type |
是 |
String |
参数解释: 数据库类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
node_infos |
是 |
Array of 表4 node_infos objects |
参数解释: 节点列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
metric_name |
String |
参数解释: 指标名称。 取值范围: 不涉及。 |
|
unit |
String |
参数解释: 单位。 取值范围: 不涉及。 |
|
metrics |
Array of 表6 metrics objects |
参数解释: 指标值。 取值范围: 不涉及。 |
请求示例
"POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/multi-nodes/single-metric"
{
"metric_name": "mem_usage",
"start_at": 1736402167049,
"end_at": 1736403967049,
"instance_infos": [
{
"datastore_type": "mysql",
"node_infos": [
{
"instance_id": "5c59fa7d6f09456b947f32922f9aeda1in01",
"node_ids": [
"09ab88b8a12340569ac056af284011d9no01"
]
}
]
}
]
}
响应示例
状态码: 200
Success.
{ "metric_name": "mem_usage",
"unit": "%",
"metrics": [
{
"instance_id": "5c59fa7d6f09456b947f32922f9aeda1in01",
"node_id": "09ab88b8a12340569ac056af284011d9no01",
"series": [
54.2,
54.18,
54.13,
54.1,
54.13,
54.15,
54.2,
54.17,
54.13,
54.18,
54.17,
54.27,
54.15,
54.1,
54.2,
54.2,
54.22,
54.17,
54.15,
54.17,
54.18,
54.17,
54.2,
54.18,
54.23,
54.17,
54.13,
54.1
],
"timestamps": [
1736402220,
1736402280,
1736402340,
1736402400,
1736402460,
1736402520,
1736402580,
1736402640,
1736402700,
1736402760,
1736402820,
1736402880,
1736402940,
1736403000,
1736403060,
1736403120,
1736403180,
1736403240,
1736403300,
1736403360,
1736403420,
1736403480,
1736403540,
1736403600,
1736403660,
1736403720,
1736403780,
1736403840
]
}
]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Success. |
|
400 |
BadRequest. |
|
500 |
InternalServerError. |
错误码
请参见错误码。