更新时间:2025-09-18 GMT+08:00

获取网卡状态

功能介绍

获取网卡状态。

调用方法

请参见如何调用API

URI

GET /v1.0/{project_id}/dms/net

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

必须是有效的dws集群ID。

取值范围

36位UUID。

默认取值

不涉及。

instance_name

String

参数解释

实例名称。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

limit

Integer

参数解释

分页单页大小。

约束限制

不涉及。

取值范围

大于0。

默认取值

不限制。

offset

Integer

参数解释

分页偏移量,从0开始,页数减1。

约束限制

不涉及。

取值范围

大于等于0。

默认取值

0

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of NetResp objects

参数解释

网卡状态响应体。

取值范围

不涉及。

表4 NetResp

参数

参数类型

描述

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

服务不可用。