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

文档中心

立即注册

边缘计算节点

弹性公网IP

批量创建弹性公网IP

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

请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必选	示例值	描述
project	String	否	`default`	弹性公网 IP 所属的项目。如果不指定该参数或参数值为空字符串，采用默认值 default。
eip_requirement_list	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 个字符。
Tags	Object[]	否	`-`	弹性公网 IP 的标签。

返回参数

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

参数	类型	示例值	描述
eips	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"
            }
        ]
    }
}

错误码

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

最近更新时间：2025.12.22 17:43:04

这个页面对您有帮助吗？

有用

无用