获取网卡状态
功能介绍
获取网卡状态。
调用方法
请参见如何调用API。
URI
GET /v1.0/{project_id}/dms/net
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cluster_id | 否 | String | 参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
| instance_name | 否 | String | 参数解释: 实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| limit | 否 | Integer | 参数解释: 分页单页大小。 约束限制: 不涉及。 取值范围: 大于0。 默认取值: 不限制。 |
| offset | 否 | Integer | 参数解释: 分页偏移量,从0开始,页数减1。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 0 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| [数组元素] | Array of NetResp objects | 参数解释: 网卡状态响应体。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| virtual_cluster_id | Integer | 参数解释: 虚拟集群ID。 取值范围: 不涉及。 |
| ctime | Long | 参数解释: 查询时间。 取值范围: 不涉及。 |
| host_id | Integer | 参数解释: 主机ID。 取值范围: 不涉及。 |
| host_name | String | 参数解释: 主机名称。 取值范围: 不涉及。 |
| instance_name | String | 参数解释: 实例名称。 取值范围: 不涉及。 |
| up | Boolean | 参数解释: 网卡状态。 取值范围: true:代表up。 false:代表down。 |
| speed | Long | 参数解释: 网卡速度(Mbps)。 取值范围: 不涉及。 |
| recv_packets | Long | 参数解释: 接收包数(个)。 取值范围: 不涉及。 |
| send_packets | Long | 参数解释: 发送包数(个)。 取值范围: 不涉及。 |
| recv_drop | Long | 参数解释: 接收丢包数(个)。 取值范围: 不涉及。 |
| recv_rate | Double | 参数解释: 接收速率(KB/s)。 取值范围: 不涉及。 |
| send_rate | Double | 参数解释: 发送速率(KB/s)。 取值范围: 不涉及。 |
| io_rate | Double | 参数解释: 网络速率(KB/s)。 取值范围: 不涉及。 |
| interface_name | String | 参数解释: 网卡名称。 取值范围: 不涉及。 |
请求示例
https://10.95.226.104:31521/v1.0/05f2cff45100d5112f4bc00b794ea08e/dms/net?limit=1&offset=0
响应示例
状态码:200
获取网卡状态成功。
[ {
"virtual_cluster_id" : 23,
"ctime" : 1668071223000,
"host_id" : 34,
"host_name" : "host-172-16-11-62",
"instance_name" : "dms-test07-dws-cn-cn-1-1",
"interface_name" : "eth2",
"up" : true,
"speed" : -1,
"recv_packets" : 490595835,
"send_packets" : 533376765,
"recv_drop" : 0,
"recv_rate" : 16.35,
"send_rate" : 11.71,
"io_rate" : null
} ] 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取网卡状态成功。 |
| 400 | 请求错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 404 | 找不到资源。 |
| 500 | 服务内部错误。 |
| 503 | 服务不可用。 |