获取弹性公网IP列表--边缘计算节点-火山引擎

文档中心

立即注册

边缘计算节点

请输入

弹性公网IP

获取弹性公网IP列表

本接口用于获取弹性公网 IP 的列表。

请求说明

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

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`ListEIPInstances`	接口名称。当前 API 的名称为 `ListEIPInstances`。
Version	String	是	`2021-04-30`	接口版本。当前 API 的版本为 `2021-04-30`。
eip_identity_list	String[]	否	`eip-wqjgxf****`	弹性公网 IP 的 ID 列表。ID 之间用半角逗号（,）分隔
cluster_names	String[]	否	`****-zzcu01`	节点名称。节点之间用半角逗号（,）分隔。
with_binder_info	Boolean	否	`false`	是否列出绑定的实例。 true：列出绑定的实例。 false（默认值）：不列出绑定的实例。
projects	String[]	否	`default`	项目列表。
with_tag_info	Boolean	否	`true`	是否返回标签信息。 true：返回标签信息。 false（默认值）：不返回标签信息。
TagFilters.N.Key	String[]	否	`env`	标签过滤器的标签键列表。
TagFilters.N.Values.N	String[]	否	`prod`	标签过滤器的标签值列表。
page	Integer	否	`1`	弹性公网 IP 列表的页码。默认值：1。
limit	Integer	否	`10`	分页查询时设置的每页行数。默认值：1000。
order_by	Integer	否	`1`	查询出来的弹性公网 IP 的排列顺序，按照创建时间排序。取值范围： 1：按照降序排列。 2（默认值）：按照升序排列。

返回参数

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

参数	类型	示例值	描述
eip_instances	Object[]	`-`	弹性公网 IP 的列表。
count	Integer	`1`	弹性公网 IP 的数量。

请求示例

GET https://veenedge.volcengineapi.com/?Action=ListEIPInstances&Version=2021-04-30
&cluster_names=**cm02
&with_binder_info=true
&<其他公共参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240708111329212E807AFA306D24****",
        "Action": "ListEIPInstances",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "eip_instances": [
            {
                "account_identity": 210006****,
                "user_identity": 0,
                "eip_identity": "eip-kqdl7****",
                "eip_name": "eip-**cm02-CMCC",
                "cluster": {
                    "cluster_name": "**cm02",
                    "country": "CN",
                    "region": "Northeast",
                    "province": "LN",
                    "city": "210200",
                    "isp": "CMCC",
                    "level": "2",
                    "alias": "**移动02"
                },
                "eip_type": "IPv4",
                "eip_addr": "120.**.**.40",
                "bandwidth_peak": 20,
                "isp": "CMCC",
                "network_type": "public",
                "binder_resource": {
                    "resource_type": "lb7",
                    "resource_identity": "veew-lb73754760243556****",
                    "resource_name": "测试1",
                    "resource_vpc_identity": "vpc-qfj78n****",
                    "resource_vpc_name": "**移动02-默认VPC",
                    "resource_vpc_subnet_cidrs": [
                        "172.**.**.64/26"
                    ]
                },
                "status": "bound",
                "desc": "",
                "billing_config": {
                    "ip_billing_method": "MonthlyPeak",
                    "bandwidth_billing_method": "MonthlyP95"
                },
                "cluster_bwp_id": 5948,
                "project": "default",
                "create_time": 1716454644,
                "update_time": 1716454666
            }
        ],
        "count": 1
    }
}

错误码

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

最近更新时间：2026.01.07 16:44:58

这个页面对您有帮助吗？

有用

无用

边缘计算节点

请求说明 #

请求参数 #

Query #

返回参数 #

请求示例 #

返回示例 #