更新时间:2023-12-25 GMT+08:00

查询配额

功能介绍

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

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

URI

GET /v1/{project_id}/quotas

样例:
GET https://{Endpoint}/v1/{project_id}/quotas?type={type}
参数说明请参见表1
表1 参数说明

名称

是否必选

参数类型

说明

project_id

String

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

type

String

  • 功能说明:根据type过滤查询指定类型的配额
  • 取值范围:
    • vpc 虚拟私有云
    • subnet 子网
    • securityGroup 安全组
    • securityGroupRule 安全组规则
    • publicIp 弹性公网IP
    • vpn 虚拟专用网络
    • vpngw VPN网关
    • vpcPeer 对等连接
    • loadbalancer 负载均衡
    • listener 负载倾听器
    • physicalConnect 物理专线
    • virtualInterface 虚拟接口
    • firewall 防火墙
    • shareBandwidthIP 单个共享带宽的IP
    • shareBandwidth 共享带宽
    • address_group 地址组
    • flow_log 流日志
    • vpcContainRoutetable 单VPC下的路由表数量
    • routetableContainRoutes 单路由表下的路由条目

请求参数

响应参数

表2 响应参数

名称

参数类型

说明

quotas

quotas object

配额列表对象,请参见表3

表3 quotas字段说明

名称

参数类型

说明

resources

Array of resource objects

资源列表对象,请参见表4

表4 resource字段说明

名称

参数类型

说明

type

String

  • 功能说明:根据type过滤查询指定类型的配额
  • 取值范围:
    • vpc 虚拟私有云
    • subnet 子网
    • securityGroup 安全组
    • securityGroupRule 安全组规则
    • publicIp 弹性公网IP
    • vpn 虚拟专用网络
    • vpngw VPN网关
    • vpcPeer 对等连接
    • loadbalancer 负载均衡
    • listener 负载倾听器
    • physicalConnect 物理专线
    • virtualInterface 虚拟接口
    • firewall 防火墙
    • shareBandwidthIP 单个共享带宽的IP
    • shareBandwidth 共享带宽
    • address_group 地址组
    • flow_log 流日志
    • vpcContainRoutetable 单VPC下的路由表数量
    • routetableContainRoutes 单路由表下的路由条目

used

Integer

  • 功能说明:已创建的资源个数
  • 取值范围:0~quota数

quota

Integer

  • 功能说明:资源的最大配额数
  • 取值范围:各类型资源默认配额数~Integer最大值

min

Integer

允许修改的配额最小值

通过接口查询单租户在VPC服务下的网络资源配额,返回值“-1”,表示配额数量不限制。

响应示例

{
    "quotas": {
        "resources": [
            {
                "type": "vpc",
                "used": 4,
                "quota": 150,
                "min": 0
            },
            {
                "type": "subnet",
                "used": 5,
                "quota": 400,
                "min": 0
            },
            {
                "type": "securityGroup",
                "used": 1,
                "quota": 100,
                "min": 0
            },
            {
                "type": "securityGroupRule",
                "used": 6,
                "quota": 5000,
                "min": 0
            },
            {
                "type": "publicIp",
                "used": 2,
                "quota": 10,
                "min": 0
            },
            {
                "type": "vpn",
                "used": 0,
                "quota": 5,
                "min": 0
            },
            {
                "type": "vpngw",
                "used": 0,
                "quota": 2,
                "min": 0
            },
            {
                "type": "vpcPeer",
                "used": 0,
                "quota": 50,
                "min": 0
            },
            {
                "type":"physicalConnect",
                "used":0,
                "quota":10,
                "min":0
            },
            {
                "type":"virtualInterface",
                "used":0,
                "quota":50,
                "min":0
            },
            {
                "type": "firewall",
                "used": 0,
                "quota": 200,
                "min": 0
            },
            {
                "type": "shareBandwidth",
                "used": 0,
                "quota": 5,
                "min": 0
            },
            {
                "type": "shareBandwidthIP",
                "used": 0,
                "quota": 20,
                "min": 0
            },
            {
                "type": "loadbalancer",
                "used": 0,
                "quota": 10,
                "min": 0
            },
            {
                "type": "listener",
                "used": 0,
                "quota": 10,
                "min": 0
            },
            {
                "type": "vpcContainRoutetable",
                "used": 0,
                "quota": 1,
                "min": 0
            },
            {
                "type": "routetableContainRoutes",
                "used": 0,
                "quota": 200,
                "min": 0
            },
            { 
                 "type": "address_group", 
                 "used": 0, 
                 "quota": 50, 
                 "min": 0 
             }
        ]
    }
}

状态码

请参见状态码

错误码

请参考错误码