文档中心

专有网络VPC API参考手册

最近更新时间：2023-04-16 17:00:00

4 弹性网卡管理

4.1 CreateElasticNetworkInterface

调用 CreateElasticNetworkInterface 接口创建弹性网卡。

4.1.1 使用说明

POST http://{endpoint}/vpc/v1.0/enis

新创建的弹性网卡处于可用（RUNNING）状态。

4.1.2 请求参数

4.1.3 返回数据

4.1.4 示例

1. 请求示例

POST http://{endpoint}/vpc/v1.0/enis

{

"PortName" : "opneApi",

"SubnetId": "snet-xxx",

"SecurityGroupIds":["sg-xxx"],

"Ipv4Address": "192.168.0.11",

"PortSecurityEnable": true

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"PortName": "opneApi",

"PortId": "port-xxx",

"RequestId": "4553c4897137c1a2988b1a7558d65541",

"SecurityGroupIds": [ "sg-xxx" ],

"Status": "RUNNING",

"BindInfo": {},

"VpcId": "vpc-xxx",

"SubnetId": "snet-xxx",

"Ipv4Address": "192.168.0.11",

"PortType": "--",

"MacAddress": "xxxx",

"CreateAt": "2022-05-12 17:41:56",

"UpdateAt": "2022-05-13 17:41:56",

"PortSecurityEnable": true

}

4.2 DeleteElasticNetworkInterface

调用 DeleteElasticNetworkInterface 接口删除弹性网卡。

4.2.1 使用说明

DELETE http://{endpoint}/vpc/v1.0/enis/{port_id}

调用 DeleteElasticNetworkInterface 删除一个弹性网卡实例。

与虚机或者弹性公网 IP 绑定的弹性网卡，需要先解绑再删除。

4.2.2 请求参数

4.2.3 返回数据

4.2.4 示例

1. 请求示例

DELETE http://{endpoint}/vpc/v1.0/enis/{port_id}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "4553c4897137c1a2988b1a7558d65541"

}

4.3 ModifyElasticNetworkInterface

调用 ModifyElasticNetworkInterface 修改弹性网卡的名称和安全组。

4.3.1 使用说明

PUT http://{endpoint}/vpc/v1.0/enis/{port_id}

4.3.2 请求参数

4.3.3 返回数据

4.3.4 示例

1. 请求示例

PUT http://{endpoint}/vpc/v1.0/enis/{port_id}

{

"PortName" : "opneApi",

"SecurityGroupIds":["sg-xxx"],

"PortSecurityEnable": true

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"PortName": "opneApi",

"PortId": "port-xxx",

"RequestId": "4553c4897137c1a2988b1a7558d65541",

"SecurityGroupIds": [ "sg-xxx" ],

"Status": "RUNNING",

"BindInfo": {},

"VpcId": "vpc-xxx",

"SubnetId": "snet-xxx",

"Ipv4Address": "192.168.0.11",

"PortType": "--",

"MacAddress": "xxxx",

"CreateAt": "2022-05-12 17:41:56",

"UpdateAt": "2022-05-13 17:41:56",

"PortSecurityEnable": true

}

4.4 GetElasticNetworkInterfaceDetail

调用 GetElasticNetworkInterfaceDetail 查询弹性网卡实例详情。

4.4.1 使用说明

GET http://{endpoint}/vpc/v1.0/enis/{port_id}

4.4.2 请求参数

4.4.3 返回数据

4.4.4 示例

1. 请求示例

GET http://{endpoint}/vpc/v1.0/enis/{port_id}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"PortName": "opneApi",

"PortId": "port-xxx",

"RequestId": "4553c4897137c1a2988b1a7558d65541",

"SecurityGroupIds": [ "sg-xxx" ],

"Status": "RUNNING",

"BindInfo": {},

"VpcId": "vpc-xxx",

"SubnetId": "snet-xxx",

"Ipv4Address": "192.168.0.11",

"PortType": "--",

"MacAddress": "xxxx",

"CreateAt": "2022-05-12 17:41:56",

"UpdateAt": "2022-05-13 17:41:56",

"PortSecurityEnable": true

}

4.5 GetElasticNetworkInterfaceList

调用 GetElasticNetworkInterfaceList 查询弹性网卡实例列表。

4.5.1 使用说明

GET http://{Endpoint}/vpc/v1.0/enis?PageSize=10&&PageNumber=1

4.5.2 请求参数

4.5.3 返回数据

4.5.4 示例

1. 请求示例

GET http://{Endpoint}/vpc/v1.0/enis?PageSize=10&&PageNumber=1

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"PageNumber": "1",

"PageSize": "10",

"Ports": [

{ "PortName": "test-openAPi",

"PortId": "port-5wgxxx",

"SecurityGroupIds": [ "sg-8kgxxx", "sg-h93xxx", "sg-ku1xxx", "sg-tzrxxx" ],

"Status": "RUNNING",

"BindInfo": { "EcsInfo": { "EcsId": "ecs-xccxxx", "EcsName": "cecloud-ecs-21031" },

"EipInfo": null },

"VpcId": "vpc-d5xxx",

"SubnetId": "snet-04xxx",

"Ipv4Address": "192.168.0.5",

"PortType": "主弹性网卡",

"MacAddress": "0E:7E:3A:92:4F:3A",

"CreatedAt": "2022-05-06 10:10:01",

"UpdatedAt": "2022-05-11 17:59:28" ,

"PortSecurityEnable": true

"RequestId": "7f35ef1509b737d10519ee09349bdf62",

"TotalCount": 1

}

4.6 AttachElasticNetworkInterfaceToInstance

调用 AttachElasticNetworkInterfaceToInstance 绑定弹性网卡到虚机。

4.6.1 使用说明

PUT http://{endpoint}/vpc/v1.0/enis/bind/{port_id}

4.6.2 请求参数

4.6.3 返回数据

4.6.4 示例

1. 请求示例

PUT http://{endpoint}/vpc/v1.0/enis/bind/{port_id}

{

"InstanceType": "ecs",

"InstanceId": "ecs-xxx"

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "4553c4897137c1a2988b1a7558d65541"

}

4.7 DetachElasticNetworkInterfaceFromInstance

调用 DetachElasticNetworkInterfaceFromInstance 解绑弹性网卡到虚机。

4.7.1 使用说明

PUT http://{endpoint}/vpc/v1.0/enis/detach/{port_id}

4.7.2 请求参数

4.7.3 返回数据

4.7.4 示例

1. 请求示例

PUT http://{endpoint}/vpc/v1.0/enis/detach/{port_id}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json

{

"RequestId": "4553c4897137c1a2988b1a7558d65541"

}

4.8 错误码

意见反馈

文档内容是否对您有帮助？

如您有其他疑问，您也可以通过在线客服来与我们联系探讨在线客服