文档首页/ 弹性公网IP EIP/ API参考/ API/ 配额/ 查询配额 - ListQuotas
更新时间：2025-10-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询配额 - ListQuotas

功能介绍

查询单租户在VPC服务下的网络资源配额，包括vpc配额、子网配额、安全组配额、安全组规则配额、弹性公网IP配额，vpn配额等。

弹性公网IP与VPC共用本接口，可在本接口中查询弹性公网IP配额。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

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

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

URI

GET /v1/{project_id}/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取项目ID请参见获取项目ID
表2 Query参数

参数

是否必选

参数类型

描述

type

否

String

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

  • 取值范围：

    • vpc

    • subnet

    • securityGroup

    • securityGroupRule

    • publicIp

    • vpn

    • vpcPeer

    • loadbalancer

    • listener

    • physicalConnect

    • virtualInterface

    • firewall

    • shareBandwidthIP

    • shareBandwidth

    • address_group

    • flow_log

    • vpcContainRoutetable

    • routetableContainRoutes

最小长度：0

最大长度：64

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

quotas

ResourceResp object

资源配额对象
表4 ResourceResp

参数

参数类型

描述

resources

Array of QuotaShowResp objects

资源配额对象

数组长度：0 - 999
表5 QuotaShowResp

参数

参数类型

描述

type

String

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

  • 取值范围：

    • vpc

    • subnet

    • securityGroup

    • securityGroupRule

    • publicIp

    • vpn

    • vpcPeer

    • loadbalancer

    • listener

    • physicalConnect

    • virtualInterface

    • firewall

    • shareBandwidthIP

    • shareBandwidth

    • address_group

    • flow_log

    • vpcContainRoutetable

    • routetableContainRoutes

最小长度：0

最大长度：36

used

Integer

  • 功能说明：已创建的资源个数

  • 取值范围：0~quota数

最小值：0

最大值：999999

quota

Integer

  • 功能说明：资源的最大配额数

  • 取值范围：各类型资源默认配额数~Integer最大值

  • 约束：资源的默认配额数可以修改，而且配额需要提前在底层配置

    • vpc默认5

    • 子网默认400

    • 安全组默认100

    • 安全组规则默认5000

    • 弹性公网IP默认10

    • vpn默认5

    • vpcPeer默认50

    • loadbalancer默认10

    • listener默认10

    • physicalConnect默认10

    • virtualInterface默认50

    • firewall默认200

    • shareBandwidth默认5

    • shareBandwidthIP默认10

    • address_group默认10

    • flow_log默认10

    • vpcContainRoutetable默认1

    • routetableContainRoutes默认200

参考默认配置为：

最小值：-1

最大值：999999

min

Integer

  • 功能说明：允许修改的配额最小值

最小值：0

最大值：999999

请求示例

查询弹性公网IP配额。

GET https://{Endpoint}/v1/{project_id}/quotas?type=publicIp

GET https://{Endpoint}/v1/{project_id}/quotas?type=publicIp

响应示例

状态码：200

GET和PUT操作正常返回

{
  "quotas" : {
    "resources" : [ {
      "type" : "vpc",
      "used" : 4,
      "quota" : 150,
      "min" : 0
    }, {
      "type" : "securityGroup",
      "used" : 1,
      "quota" : 400,
      "min" : 0
    }, {
      "type" : "securityGroupRule",
      "used" : 6,
      "quota" : 5000,
      "min" : 0
    }, {
      "type" : "publicIp",
      "used" : 2,
      "quota" : 10,
      "min" : 0
    } ]
  }
}

状态码

状态码

描述

200

GET和PUT操作正常返回

错误码

请参见错误码。

父主题： 配额

相关文档