华为云计算 云知识 查询配额接口ListQuotas
查询配额接口ListQuotas

 

功能介绍

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

EIP与VPC共用本接口,可在本接口中查询EIP配额。

调试

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

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

    • EIP默认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

请求示例

查询EIP配额。

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

错误码

请参见错误码

 

上一篇:使用CDN加速后流量高峰轻松应对 下一篇:网域名称服务器

华为云开发者中心为开发者提供所有云服务的API及API手册、各产品的SDK、可服务的节点区域和各服务的终端节点EndPoint和在使用华为云产品时需要用到的CLI工具、业务工具等的下载及使用说明。