查询配额 - 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：弹性公网IP。 vpn：虚拟专用网络。 vpcPeer: 对等连接。 loadbalancer：负载均衡。 listener：负载倾听器。 physicalConnect：物理专线。 virtualInterface：虚拟接口。 firewall：防火墙。 shareBandwidthIP：单个共享带宽的IP。 shareBandwidth：共享带宽。 address_group：地址组。 flow_log：流日志。 vpcContainRoutetable：单VPC下的路由表数量。 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：弹性公网IP。 vpn：虚拟专用网络。：vpn网关。 vpcPeer: 对等连接。 loadbalancer：负载均衡。 listener：负载倾听器。 physicalConnect：物理专线。 virtualInterface：虚拟接口。 firewall：防火墙。 shareBandwidthIP：单个共享带宽的IP。 shareBandwidth：共享带宽。 address_group：地址组。 flow_log：流日志。 vpcContainRoutetable：单VPC下的路由表数量。 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
    } ]
  }
}