文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 全域弹性公网IP/ 查询全域弹性公网IP个数 - CountGlobalEips
更新时间：2026-04-17 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询全域弹性公网IP个数 - CountGlobalEips

功能介绍

查询全域弹性公网IP个数。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:globalEips:count

    List

    globalEip *

    -

    eip:globalEips:list

    -

URI

GET /v3/{domain_id}/global-eips/count

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

最小长度：5

最大长度：32
表2 Query参数

参数

是否必选

参数类型

描述

id

否

Array of strings

根据ID过滤，支持多值查询，查询条件格式：id=xxx&id=xxx。

internet_bandwidth_id

否

Array of strings

根据全域公网带宽的ID过滤，支持多值查询，查询条件格式：internet_bandwidth_id=xxx&internet_bandwidth_id=xxx。

name

否

Array of strings

根据名称过滤，支持多值查询，查询条件格式：name=xxx&name=xxx。

name_like

否

String

根据名称模糊匹配

access_site

否

Array of strings

根据接入点过滤，支持多值查询，查询条件格式：access_site=xxx&access_site=xxx。

geip_pool_name

否

Array of strings

根据全域弹性公网IP池名称过滤，支持多值查询，查询条件格式：geip_pool_name=xxx&geip_pool_name=xxx。

isp

否

Array of strings

根据运营商线路过滤，支持多值查询，查询条件格式：isp=xxx&isp=xxx。

ip_version

否

Array of integers

根据IP版本过滤

ip_address

否

Array of strings

根据ip地址过滤

ipv6_address

否

Array of strings

根据ipv6地址过滤

freezen

否

Array of booleans

根据是否冻结过滤

polluted

否

Array of booleans

根据是否污染过滤

internet_bandwidth_is_null

否

Array of booleans

根据是否绑定全域公网带宽过滤

gcb_bandwidth_is_null

否

Array of booleans

根据是否绑定骨干带宽过滤

status

否

Array of strings

  • 参数解释：根据全域弹性公网IP状态过滤。

  • 约束限制：不涉及

  • 取值范围：

    • IDLE：全域弹性公网IP未绑定实例。

    • INUSE：全域弹性公网IP使用中。

    • FREEZED：全域弹性公网IP被冻结。

    • PENDING_CREATE:全域弹性公网IP创建中。

    • PENDING_UPDATE：全域弹性公网IP更新中。

  • 默认取值：不涉及

associate_instance_info.region

否

Array of strings

根据绑定实例所属的局点过滤

associate_instance_info.public_border_group

否

Array of strings

  • 功能说明：根据绑定实例所属的边缘信息过滤

  • 取值范围：center、边缘站点名称

associate_instance_info.instance_site

否

Array of strings

根据绑定实例所在的站点过滤

associate_instance_info.instance_type

否

Array of strings

  • 参数解释：根据绑定实例的类型过滤，支持多值查询，查询条件格式：id=xxx&id=xxx。

  • 约束限制：不涉及

  • 取值范围：

    • DC-CONNECT-GATEWAY：云专线。

    • IPV6-DC-CONNECT-GATEWAY:IPV6云专线。

    • ECS：弹性云服务器。

    • IPV6-ECS：IPV6弹性云服务器。

    • PORT：弹性网卡。

    • IPV6-PORT：IPV6弹性网卡。

    • VIP:虚拟IP。

    • IPV6-VIP：IPV6虚拟IP。

    • ELB：弹性负载均衡。

    • IPV6-ELB：IPV6弹性负载均衡。

    • NATGW：NAT网关。

  • 默认取值：不涉及

associate_instance_info.instance_id

否

Array of strings

根据绑定实例的ID过滤

associate_instance_info.project_id

否

Array of strings

query by associate_instance_info.project_id

enterprise_project_id

否

Array of strings

根据企业项目ID过滤

tags

否

Array of strings

根据标签过滤，过滤格式为key1|value1,key2|value2,...

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户的Token，获取用户Token请参见获取用户Token

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

本次请求编号
表5 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

global_eip

CountGlobalEips object

全域弹性公网IP数目
表6 CountGlobalEips

参数

参数类型

描述

count

Integer

全域弹性公网IP个数

请求示例

查询全域弹性公网IP个数

GET https://{Endpoint}/v3/{domain_id}/global-eips/count

响应示例

状态码：200

OK

{
  "global_eip" : {
    "count" : 2
  },
  "request_id" : "d21a6efb63989543dc5f694bf2f6b095"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 全域弹性公网IP

相关文档