批量创建弹性公网IP--边缘计算节点-火山引擎

文档中心

立即注册

导航

批量创建弹性公网IP

最近更新时间：2025.07.31 19:30:51首次发布时间：2022.02.25 18:58:31

本接口用于批量创建弹性公网 IP。

请求说明

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

请求参数

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

Query

参数	类型	是否必填	示例值	描述
Action	String	是	BatchCreateEIPInstances	要执行的操作，取值：BatchCreateEIPInstances。
Version	String	是	2021-04-30	API的版本，取值：2021-04-30。

Body

参数	类型	是否必填	示例值	描述
project	String	否	default	弹性公网 IP 所属的项目。如果不指定该参数或参数值为空字符串，采用默认值 default。
eip_requirement_list	Array of Object	是	-	弹性公网 IP 的需求列表。
eip_name	String	否	eip-test	弹性公网 IP 的名称。命名规则如下：允许 5~20 个字符。支持汉字、大写字母、小写字母、数字和特殊字符 ()`~!@#$%^&-+=_\|{}[]:;'<>,.?/。不能包含双引号（"）、反斜线（ \）和空格，且不能以正斜线（/）开头。系统会自动在您指定的名称后面添加节点信息，最终生成的名称的结构为：<指定的名称>-<节点名称>。当您创建多个弹性公网IP时，系统还会为名称添加数字后缀、以区分不同的弹性公网IP。第一个创建出来的实例的名称不会被添加数字后缀。例如，如果您在北京电信节点下创建了3个弹性公网IP并指定名称为“dev_a”，最终系统生成的名称将分别是dev_a-bjct、dev_a-bjct-1和dev_a-*bjct-2。
eip_type	String	是	IPv4	弹性公网 IP 的类型。取值范围： IPv4：IPv4 类型。 IPv6：IPv6 类型。说明 IPv6 类型的弹性公网 IP 只能绑定到支持 IPv4/IPv6 双栈的负载均衡实例或边缘实例。如需使用支持 IPv4/IPv6 双栈的资源，请提交工单或联系客服人员。
network_type	String	是	public	弹性公网 IP 的网络类型。取值范围： public：公网类型。
bandwidth_peak	Integer	是	20	带宽峰值。取值范围：20 ~ 5000。单位：Mbps。取值只能是 5 的倍数。
desc	String	否	used for testing	弹性公网 IP 的描述。最多可输入 80 个字符。

返回参数

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

参数	类型	示例值	描述
eips	Array of Object	-	弹性公网 IP 的列表。

请求示例

POST https://veenedge.volcengineapi.com/?Action= BatchCreateEIPInstances&Version=2021-04-30
&<其他公共参数>
{
  "eip_requirement_list": [
    {
      "cluster_name": "**cu01",
      "eip_num": 1
    }
  ],
  "eip_name": "eip-test",
  "eip_type": "IPv4",
  "network_type": "public",
  "bandwidth_peak": 20,
  "desc": "used for testing"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202507311704078D2FA339CEE1AF10****",
        "Action": "BatchCreateEIPInstances",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "eips": [
            {
                "account_identity": 210006****,
                "user_identity": 0,
                "eip_identity": "eip-6jcwv ****",
                "eip_name": "eip-test-**cu01",
                "cluster": {
                    "cluster_name": "**cu01",
                    "country": "CN",
                    "region": "NorthChina",
                    "province": "SX",
                    "city": "141000",
                    "isp": "CUCC",
                    "level": "3",
                    "alias": "**联通01"
                },
                "eip_type": "IPv4",
                "eip_addr": "60.**.**.253",
                "bandwidth_peak": 20,
                "isp": "CUCC",
                "network_type": "public",
                "status": "creating",
                "desc": "used for testing",
                "billing_config": {
                    "ip_billing_method": "MonthlyPeak",
                    "bandwidth_billing_method": "MonthlyP95"
                },
                "cluster_bwp_id": 5123,
                "project": "default",
                "is_overdue": false,
                "allocate_type": "system",
                "create_time": 1753952649,
                "update_time": 1753952649,
                "create_timestamp": "2025-07-31T17:04:09Z"
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
500	ConflictOperationExists	Conflict operation exists	存在冲突操作