文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 配额/ 查询租户全域弹性公网IP配额 - ListGeipResourceQuotas
更新时间:2026-04-17 GMT+08:00
分享

查询租户全域弹性公网IP配额 - ListGeipResourceQuotas

功能介绍

查询租户全域弹性公网IP配额。

调试

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

授权信息

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

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

URI

GET /v3/{domain_id}/geip/quotas

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

String

最小长度:5

最大长度:32

表2 Query参数

参数

是否必选

参数类型

描述

type

Array of strings

  • 功能说明:根据配额类型过滤查询指定类型的配额

  • 约束限制:不涉及

  • 取值范围:

    • geip:全域弹性公网IP。

    • geip_segment:全域弹性公网IP段。

    • internetBandwidthIP:全域公网带宽绑定的IP。

    • internetBandwidth:全域公网带宽。

  • 默认取值:不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

响应参数

状态码:200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

本次请求编号

表5 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

quotas

ListQuotas object

请求成功返回的配额列表

表6 ListQuotas

参数

参数类型

描述

resources

Array of ResourcesInfo objects

资源列表

表7 ResourcesInfo

参数

参数类型

描述

type

String

  • 功能说明:根据配额类型过滤查询指定类型的配额

  • 约束限制:不涉及

  • 取值范围:

    • geip:全域弹性公网IP。

    • geip_segment:全域弹性公网IP段。

    • internetBandwidthIP:全域公网带宽绑定的IP。

    • internetBandwidth:全域公网带宽。

  • 默认取值:不涉及

used

Integer

已使用配额

quota

Integer

总配额数

min

Integer

最小配额值

请求示例

查询租户全域弹性公网IP配额

GET https://{Endpoint}/v3/{domain_id}/geip/quotas

响应示例

状态码:200

OK

{
  "quotas" : {
    "resources" : [ {
      "type" : "geip",
      "used" : 3,
      "quota" : 200,
      "min" : 0
    }, {
      "type" : "geip_segment",
      "used" : 1,
      "quota" : 50,
      "min" : 0
    }, {
      "type" : "internetBandwidth",
      "used" : 3,
      "quota" : 20,
      "min" : 0
    }, {
      "type" : "internetBandwidthIP",
      "used" : 1,
      "quota" : 5,
      "min" : 0
    } ]
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档