查询弹性网卡列表
更新时间：2024-11-29
接口描述
查询弹性网卡列表。
请求结构
GET /v2/vpc/eni?vpcId=&name=&instanceId=&maker=&maxKeys=&privateIpAddress={ip1,ip2} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| vpcId | String | 否 | Query参数 | 弹性网卡所属的VPC的ID |
| instanceId | String | 否 | Query参数 | 弹性网卡挂载主机ID |
| name | String | 否 | Query参数 | 弹性网卡名称 |
| privateIpAddress | List<String> | 否 | Query参数 | 弹性网卡内网IP地址，支持单IP或者多IP查询（多IP用英文逗号隔开）；单IP后缀模糊匹配，多IP精确匹配 |
| marker | String | 否 | Query参数 | 标记查询的起始位置 |
| maxKeys | integer | 否 | Query参数 | 每页包含的最大数量，1-1000，默认1000 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| enis | List<Eni> | 弹性网卡列表 |
| isTruncated | boolean | true表示后面还有数据，false表示已经是最后一页 |
| marker | string | 标记查询的起始位置 |
| maxKeys | integer(int32) | 每页包含的最大数量 |
| nextMarker | string | 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现 |
请求示例
GET /v2/vpc/eni?vpcId=vpc-w7redbfj5frg&name=testeni&maxKeys=1 HTTP/1.1
Host: bec.baidubce.com
authorization: bce-auth-v1/c3119080364d11e8912505e5e0ae9978/2023-04-02T08:14:25Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/xxx返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
Date: Mon, 02 Apr 2023 08:14:25 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"enis": [
{
"eniId": "eni-cuij4grvpkyf",
"name": "testeni",
"description": "",
"vpcId": "vpc-w7redbfj5frg",
"subnetId": "sbn-0apxrzlye54r",
"securityGroupIds": [
"sg-dzn5bikn",
"sg-2a7icbeg"
],
"privateIpSet": [
{
"primary": true,
"privateIpAddress": "192.168.0.6"
}
],
"status": "available",
"macAddress": "xx:xx:xx:xx:xx:xx",
"instanceId": "vm-xxxxx",
"regionId": "cn-hangzhou-cm",
"createTime": "2022-04-01T01:34:01Z"
}
],
"isTruncated": false,
"marker": null,
"nextMarker": null,
"maxKeys": 1,
}Model对象定义
Eni
| 参数名称 | 类型 | 描述 |
|---|---|---|
| eniId | String | 弹性网卡的ID |
| name | String | 弹性网卡的名称 |
| description | String | 弹性网卡的描述 |
| instanceId | String | 挂载的云主机ID |
| macAddress | String | 网卡的mac地址 |
| vpcId | String | 网卡所属的vpcId |
| subnetId | String | 网卡所属的子网ID |
| securityGroupIds | List<String> | 网卡关联的安全组ID集合 |
| regionId | String | 网卡所属的节点ID |
| status | String | 网卡的状态： available：未挂载，inuse：已挂载， attaching：挂载中， detaching：卸载中 |
| privateIpSet | List<PrivateIP> | 网卡的IP集合 |
PrivateIP
| 参数名称 | 类型 | 描述 |
|---|---|---|
| primary | boolean | 是否是主IP，true为主IP，false为辅助IP |
| privateIpAddress | String | 内网IP地址 |