查询弹性网卡列表
所有文档
menu

边缘计算节点 BEC

查询弹性网卡列表

产品详情立即开通

接口描述

查询弹性网卡列表。

请求结构

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地址

上一篇
创建弹性网卡
下一篇
查询指定的弹性网卡