创建弹性网卡--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

创建弹性网卡

最近更新时间：2025.12.17 14:40:30首次发布时间：2025.12.17 14:07:19

本接口用于创建弹性网卡。

请求说明

请求方式：POST
请求地址：https://veenedge.volcengineapi.com/?Action=CreateENIInstance&Version=2021-04-30

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。其他公共参数，请参见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`CreateENIInstance`	接口名称。当前 API 的名称为 `CreateENIInstance`。
Version	String	是	`2021-04-30`	接口版本。当前 API 的版本为 `2021-04-30`。

Body

参数	类型	是否必选	示例值	描述
eni_name	String	是	`eni_testing`	弹性网卡名称。命名规则如下：允许 5~20 个字符。支持汉字、大写字母、小写字母、数字。支持以下特殊字符： ()`~!@#$%^&*-+=_\|{}[]:;'<>,.?/。不能包含空格，且不能以正斜线（/）开头。
desc	String	否	`desc_testing`	弹性网卡的描述。长度不能超过 128 个字符。
cluster_name	String	是	`bd**cu03`	节点名称。
vpc_id	String	是	`vpc-h294p****`	私有网络 ID。
subnet_id	String	否	`subnet-2j48lqz64b****`	子网 ID。如果您指定了自定义私有网络，您必须指定子网。如果您指定了默认私有网络，您无需指定子网。系统会将弹性网卡分配到该私有网络下的默认子网。
is_enhanced	Boolean	否	`false`	是否为增强联网类型网卡。取值范围： true：增强联网类型网卡。 false（默认值）：非增强联网类型网卡。说明如需使用该功能，请提交工单进行申请。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结果。

参数	类型	示例值	描述
eni_identity	String	`eni-h4bwdmbkmhb****`	弹性网卡的唯一标识。

请求示例

POST https://veenedge.volcengineapi.com/?Action=CreateENIInstance&Version=2021-04-30
<其他公共参数>
{
    "eni_name": "eni_testing",
    "cluster_name": "bd**cu03",
    "vpc_id": "vpc-h294p****",
    "subnet_id": "subnet-2j48lqz64b****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20251205154204EB8F3AD4CD513C61****",
        "Action": "CreateENIInstance",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "eni_identity": "eni-h4bwdmbkmhb****"
    }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。