1. 接口描述
本接口（DescribeNetworkInterfaces）用于查询弹性网卡信息。
接口请求域名：vpc.api.qcloud.com
2. 输入参数
以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，详情请参见 公共请求参数 页面。其中，此接口的 Action 字段为 DescribeNetworkInterfaces。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| vpcId | 否 | String | 弹性网卡对应的私有网络 ID，例如：vpc-7t9nf3pu |
| networkInterfaceId | 否 | String | 系统分配的弹性网卡 ID，例如：eni-m6dyj72l |
| eniName | 否 | String | 弹性网卡名称，支持模糊搜索 |
| eniDescription | 否 | String | 弹性网卡描述，支持模糊搜索 |
| instanceId | 否 | String | 云服务器实例 ID，例如：ins-xx44545f |
| offset | 否 | Int | 初始行的偏移量，默认为0 |
| limit | 否 | Int | 每页行数，默认为20，最大支持50 |
| orderField | 否 | String | 按某个字段排序。 支持字段：eniName,createTime，默认按createTime |
| orderDirection | 否 | String | 升序（asc）或降序（desc），默认：desc |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | Int | 错误码。0：成功，其他值：失败 |
| message | String | 错误信息 |
| data.totalNum | Int | 弹性网卡总数量 |
| data.data | Array | 弹性网卡信息数组 |
data数组：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| data.n.vpcId | String | 弹性网卡对应的私有网络ID。例如：vpc-8e0ypm3z |
| data.n.subnetId | String | 弹性网卡对应的子网ID。例如：subnet-0ap8nwca |
| data.n.zoneId | Int | 弹性网卡对应的子网所在的可用区ID。例如：200001 |
| data.n.eniName | String | 弹性网卡名称 |
| data.n.eniDescription | String | 弹性网卡描述 |
| data.n.networkInterfaceId | String | 弹性网卡ID。例如：eni-m6dyj72l |
| data.n.primary | Bool | 是否为主网卡。true：主网卡；false：普通网卡 |
| data.n.macAddress | String | 弹性网卡mac地址。例如：02:81:60:cb:27:37 |
| data.n.privateIpAddressesSet | Array | 弹性网卡绑定的 IP 信息 |
| data.n.instanceSet | Object | 弹性网卡绑定的云服务器信息 |
| data.n.groupSet | Array | 弹性网卡绑定的安全组信息 |
privateIpAddressesSet 信息数组：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| privateIpAddress | String | IP地址 |
| primary | Bool | 是否为主IP，true：是；false：否 |
| description | String | 备注 |
| wanIp | String | 公网IP |
| isWanIpBlocked | Bool | 外网IP是否被封堵 |
| eipId | String | 弹性公网IP ID |
instanceSet 信息：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceId | String | 腾讯云服务器实例ID，例如：ins-xx44545f |
| attachTime | String | 绑定时间，例如：2016-02-15 19:20:54 |
groupSet 信息数组：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sgId | String | 安全组ID，例如：sg-dfg1df54 |
| sgName | String | 安全组名称 |
| projectId | Int | 安全组项目ID |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码，更多公共错误码详见 VPC错误码。
| 错误码 | 描述 |
|---|---|
| InvalidVpc.NotFound | 无效的 VPC，VPC 资源不存在。请再次核实您输入的资源信息是否正确，可通过 DescribeVpcEx 接口查询VPC |
| InvalidNetworkInterface.NotFound | 无效的弹性网卡，弹性网卡资源不存在。请再次核实您输入的资源信息是否正确，可通过 DescribeNetworkInterfaces 接口查询弹性网卡 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=DescribeNetworkInterfaces &<公共请求参数> &vpcId=vpc-fyc4pilj
输出
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"totalNum": 3,
"data": [{
"vpcId": "vpc-fyc4pilk",
"vpcName": "test",
"subnetId": "subnet-pq7ptksb",
"zoneId": 100002,
"eniName": "大",
"eniDescription": "",
"networkInterfaceId": "eni-d6m4m0iy",
"primary": false,
"macAddress": "20:90:6F:59:8D:79",
"createTime": "2017-08-31 11:33:59",
"flowLogsSet": [],
"privateIpAddressesSet": [{
"privateIpAddress": "10.53.54.19",
"primary": true,
"wanIp": "119.29.158.39",
"description": "asdfasdfasdf",
"isWanIpBlocked": false,
"eipId": "eip-07vqn979"
}],
"instanceSet": {
"instanceId": "ins-7s7zjjcz",
"attachTime": "2017-12-12 11:55:07"
},
"groupSet": [{
"sgId": "sg-lb62wxwb",
"sgName": "asdfsadf",
"projectId": 1079263
},
{
"sgId": "sg-ikmc8kcy",
"sgName": "全drop",
"projectId": 0
}
]
},
{
"vpcId": "vpc-fyc4pilk",
"vpcName": "test",
"subnetId": "subnet-pq7ptksb",
"zoneId": 100002,
"eniName": "手动",
"eniDescription": "",
"networkInterfaceId": "eni-ay1ac9c7",
"primary": false,
"macAddress": "20:90:6F:94:86:77",
"createTime": "2017-07-28 20:09:34",
"flowLogsSet": [],
"privateIpAddressesSet": [{
"privateIpAddress": "10.53.54.230",
"primary": true,
"wanIp": "",
"description": "",
"isWanIpBlocked": false,
"eipId": ""
},
{
"privateIpAddress": "10.53.54.231",
"primary": false,
"wanIp": "",
"description": "",
"isWanIpBlocked": false,
"eipId": ""
}
],
"instanceSet": {
"instanceId": "",
"attachTime": ""
},
"groupSet": [{
"sgId": "sg-lb62wxw9",
"sgName": "asdfsadf",
"projectId": 1079263
},
{
"sgId": "sg-37tmkdiz",
"sgName": "Windows 放通3389端口-20170928143645736",
"projectId": 0
}
]
},
{
"vpcId": "vpc-fyc4pilk",
"vpcName": "test",
"subnetId": "subnet-pq7ptksb",
"zoneId": 100002,
"eniName": "新建弹性网卡手动",
"eniDescription": "",
"networkInterfaceId": "eni-a7hx9qae",
"primary": false,
"macAddress": "20:90:6F:31:88:B4",
"createTime": "2017-07-28 17:39:39",
"flowLogsSet": [],
"privateIpAddressesSet": [{
"privateIpAddress": "10.53.54.200",
"primary": true,
"wanIp": "",
"description": "",
"isWanIpBlocked": false,
"eipId": ""
}],
"instanceSet": {
"instanceId": "",
"attachTime": ""
},
"groupSet": [{
"sgId": "sg-lb62wxwe",
"sgName": "asdfsadf",
"projectId": 1079263
},
{
"sgId": "sg-5y2tai6e",
"sgName": "createPolicy_repair_test",
"projectId": 0
},
{
"sgId": "sg-q7bvssoa",
"sgName": "del usg test",
"projectId": 0
},
{
"sgId": "sg-0cgr10ie",
"sgName": "bilibili no icmp",
"projectId": 0
},
{
"sgId": "sg-ei2rr0qf",
"sgName": "广州",
"projectId": 0
},
{
"sgId": "sg-oodf2fc6",
"sgName": "offset",
"projectId": 0
}
]
}
]
}
}
