文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 全域公网带宽限制/ 全域公网带宽限制列表 - ListInternetBandwidthLimits
更新时间:2026-09-24 GMT+08:00
分享

全域公网带宽限制列表 - ListInternetBandwidthLimits

功能介绍

查询全域公网带宽限制列表。

调试

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

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/{domain_id}/geip/internet-bandwidth-limits

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

参数解释:

租户账号ID,获取租户账号ID请参见租户账号ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

最小长度:5

最大长度:32

表2 Query参数

参数

是否必选

参数类型

描述

fields

否

Array of strings

参数解释:

查询指定的字段。

约束限制:

格式为fields=A&fields=B&fields=C&......

取值范围:

支持的字段:

  • id

  • charge_mode

  • min_size

  • ext_limit

  • max_size

默认取值:

不涉及。

sort_key

否

Array of strings

参数解释:

按照sort_key指定的字段排序。

约束限制:

不涉及。

取值范围:

  • id

默认取值:

不涉及。

sort_dir

否

Array of strings

参数解释:

排序方向。

约束限制:

不涉及。

取值范围:

  • asc:升序

  • desc:降序

默认取值:

不涉及。

charge_mode

否

Array of strings

参数解释:

计费模式,客户支持的计费类型可通过全域公网带宽限制列表接口查询。

约束限制:

其中95计费需要满足一定条件才可使用,具体请见计费类。

取值范围:

  • bandwidth:按带宽计费

  • 95peak_plus_1000:按增强型95计费

  • 95peak_bidirection:按双向型传统95计费

  • 95peak_guar:带保底传统型95计费

  • 95peak_avr:95峰值平均计费根据计费模式过滤

默认取值:

不涉及。

type

否

String

参数解释:

根据全域公网带宽类型过滤。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户的Token,如何获取用户Token请参见获取用户Token。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

本次请求编号

表5 响应Body参数

参数

参数类型

描述

request_id

String

参数解释:

请求ID。

取值范围:

不涉及。

internet_bandwidth_limits

Array of ListInternetBandwidthLimits objects

参数解释:

全域公网带宽限制列表。

取值范围:

不涉及。

表6 ListInternetBandwidthLimits

参数

参数类型

描述

id

String

参数解释:

全域公网带宽限制的ID。

取值范围:

不涉及。

charge_mode

String

参数解释:

计费模式,客户支持的计费类型可通过全域公网带宽限制列表接口查询。

其中95计费需要满足一定条件才可使用,具体请见计费类。

取值范围:

  • bandwidth:按带宽计费

  • traffic:按流量计费

  • 95peak_plus_1000:按增强型95计费

  • 95peak_bidirection:按双向型传统95计费

  • 95peak_guar:带保底传统型95计费

  • 95peak_avr:95峰值平均计费

min_size

Integer

参数解释:

该类型全域公网带宽可购买的最小size。

取值范围:

不涉及。

ext_limit

ExtLimitPojo object

参数解释:

附属信息。

取值范围:

不涉及。

max_size

Integer

参数解释:

该类型全域公网带宽可购买的最大size。

取值范围:

不涉及。

type

String

参数解释:

全域公网带宽类型。

取值范围:

不涉及。

表7 ExtLimitPojo

参数

参数类型

描述

min_ingress_size

Integer

参数解释:

入网全域公网带宽的最小size。

取值范围:

不涉及。

max_ingress_size

Integer

参数解释:

入网全域公网带宽的最大size。

取值范围:

不涉及。

ratio_95peak

Integer

参数解释:

增强95保底率。

取值范围:

不涉及。

请求示例

查询全域公网带宽限制列表

GET https://{Endpoint}/v3/{domain_id}/geip/internet-bandwidth-limits

响应示例

状态码:200

{
  "request_id" : "d224afc0e7add65c715707dbadd3004a",
  "internet_bandwidth_limits" : [ {
    "id" : "97320d4e-d260-4191-a033-59897cd58e4d",
    "charge_mode" : "95peak_guar",
    "min_size" : 100,
    "max_size" : 2000,
    "ext_limit" : {
      "min_ingress_size" : 100,
      "max_ingress_size" : 2000,
      "ratio_95peak" : 0
    },
    "type" : "standard"
  }, {
    "id" : "e22cf02e-882d-41ec-8816-60e550ca4233",
    "charge_mode" : "traffic",
    "min_size" : 1,
    "max_size" : 2000,
    "ext_limit" : null,
    "type" : "standard"
  }, {
    "id" : "6f5283ce-c6c5-4d1b-b627-1d4555231a70",
    "charge_mode" : "bandwidth",
    "min_size" : 1,
    "max_size" : 2000,
    "ext_limit" : null,
    "type" : "ccc"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档