更新时间:2024-04-03 GMT+08:00
分享

查询配额

功能介绍

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

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

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取项目ID请参见获取项目ID

最小长度:0

最大长度:32

表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操作正常返回

错误码

请参见错误码

相关文档