查询主机监控维度指标信息
功能介绍
根据ECS/BMS资源ID查询磁盘、挂载点、进程、显卡、RAID控制器维度指标信息。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/instances/{instance_id}/agent-dimensions
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目编号。 最小长度：1 最大长度：64 |
instance_id |
是 |
String |
资源ID，如：4270ff17-aba3-4138-89fa-820594c39755。 最小长度：36 最大长度：36 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
dim_name |
是 |
String |
维度名称，枚举类型，类型有： mount_point：挂载点, disk：磁盘, proc：进程, gpu：显卡, raid: RAID控制器, 枚举值：
|
dim_value |
否 |
String |
维度值，32位字符串，如：2e84018fc8b4484b94e89aae212fe615。 最小长度：32 最大长度：32 |
offset |
否 |
Integer |
分页偏移量 最小值：0 最大值：2147483647 缺省值：0 正则匹配：^(0|[1-9][0-9]*)$ |
limit |
否 |
Integer |
分页大小 最小值：1 最大值：1000 缺省值：1000 正则匹配：^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|1000)$ |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Content-Type |
是 |
String |
发送的实体的MIME类型。默认使用application/json; charset=UTF-8。 缺省值：application/json; charset=UTF-8 最小长度：1 最大长度：64 |
X-Auth-Token |
是 |
String |
用户Token 最小长度：1 最大长度：16384 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
dimensions |
Array of AgentDimension objects |
维度信息 数组长度：0 - 2147483647 |
count |
Integer |
维度信息总数 最小值：0 最大值：2147483647 |
参数 |
参数类型 |
描述 |
|---|---|---|
name |
String |
维度名称，枚举类型，类型有： mount_point：挂载点， disk：磁盘， proc：进程， gpu：显卡， raid: RAID控制器 枚举值：
|
value |
String |
维度值，32位字符串，如：2e84018fc8b4484b94e89aae212fe615 最小长度：32 最大长度：32 |
origin_value |
String |
实际维度信息，字符串，如：vda。 最小长度：1 最大长度：1024 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：256 |
error_msg |
String |
错误信息 最小长度：0 最大长度：256 |
request_id |
String |
请求id 最小长度：0 最大长度：256 |
状态码： 404
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：256 |
error_msg |
String |
错误信息 最小长度：0 最大长度：256 |
request_id |
String |
请求id 最小长度：0 最大长度：256 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：256 |
error_msg |
String |
错误信息 最小长度：0 最大长度：256 |
request_id |
String |
请求id 最小长度：0 最大长度：256 |
请求示例
查询资源ID为4270ff17-aba3-4138-89fa-820594c39755的主机监控维度指标信息。
/v2/{project_id}/instances/4270ff17-aba3-4138-89fa-820594c39755/agent-dimensions?offset=0&limit=10
响应示例
状态码： 200
查询成功
{
"dimensions" : [ {
"name" : "disk",
"value" : "2e84018fc8b4484b94e89aae212fe615",
"origin_value" : "vda"
}, {
"name" : "disk",
"value" : "6a1b2de69eeb9a037ea23de6b529394d",
"origin_value" : "vdc"
} ],
"count" : 10
}
状态码
状态码 |
描述 |
|---|---|
200 |
查询成功 |
400 |
参数校验失败 |
404 |
资源不存在 |
500 |
系统内部错误 |
错误码
请参见错误码。
