基本信息

Action

DescribeNics

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

参数名 类型 描述 是否必须

nics.n

String

nic ID

否

nic_name

String

网卡名称

否

status

String

网卡状态：available: 空闲；in-use: 正在使用中

否

vxnets.n

String

网卡对应的vxnet_id

否

vxnet_type

Array

网络类型， 0:自管；1.受管; 2.基础网络

否

返回数据

此接口除了返回公共响应参数外，还返回以下参数。关于公共响应参数的更多信息，请参见前文内容。

参数名 类型 描述

nic_set

Array

JSON 格式的网卡列表，每项参数可见下面 Response Item

total_count

Integer

根据过滤条件得到的网卡总数

nic_set 参数说明如下。

参数名 类型 描述

nic_id

String

NIC ID

nic_name

String

NIC名称

status

String

网卡状态：available: 空闲；in-use: 正在使用中

instance_id

String

挂载的云服务器 ID

vxnet_id

String

网络vxnet_id

create_time

TimeStamp

网卡创建时间, 为UTC时间, 格式可参见 ISO8601.

status_time

TimeStamp

网卡最近一次状态变更时间, 为UTC时间, 格式可参见 ISO8601.

sequence

Integer

网卡在云服务器上的序号

role

Integer

网卡角色 1:主网卡，每个云服务器一个，是云服务器绑定eip，防火墙时的默认网卡; 0：从网卡，每个云服务器可以挂载多个

请求示例

https://api.<your_domain>/iaas/?action=DescribeNics
&nics.1=52:54:00:00:12:34
&COMMON_PARAMS

返回示例

{
  "nic_set":[
      {
          "vxnet_id":"vxnet-1234567",
          "nic_name":"nic1",
          "status:"in-use",
          "tags":[],
          "role": 1,
          "sequence":0,
          "instance_id":"",
          "private_ip":"192.168.1.2",
          "security_group":"",
          "nic_id":"52:54:00:00:12:34"
          "status_time":"2016-12-23T13:35:56",
          "create_time":"2016-12-23T13:35:56",
      }
  ],
  "ret_code":0
}