更新时间:2022-01-25 GMT+08:00

查询配额

功能介绍

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

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

URI

GET /v1/{project_id}/quotas

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

名称

是否必选

参数类型

说明

project_id

String

项目ID

type

String

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

取值范围:vpc,subnet,securityGroup,securityGroupRule,publicIp,vpn,vpngw,vpcPeer,firewall,shareBandwidth,shareBandwidthIP,loadbalancer,listener

请求消息

  • 请求参数
  • 请求样例
    GET https://{Endpoint}/v1/{project_id}/quotas

响应消息

  • 响应参数
    表2 响应参数

    名称

    参数类型

    说明

    quotas

    Object

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

    表3 quotas字段说明

    名称

    参数类型

    说明

    resources

    Array of resource objects

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

    表4 resource字段说明

    名称

    参数类型

    说明

    type

    String

    • 功能说明:根据type过滤查询指定类型的配额
    • 取值范围:vpc,subnet,securityGroup,securityGroupRule,publicIp,vpn,vpngw,vpcPeer,firewall,shareBandwidth,shareBandwidthIP

    used

    Integer

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

    quota

    Integer

    • 功能说明:资源的最大配额数
    • 取值范围:各类型资源默认配额数~Integer最大值
    • 约束:资源的默认配额数可以修改,而且配额需要提前在底层配置,参考默认配置为:vpc默认5,子网默认100,安全组默认100,安全组规则默认5000,弹性公网IP默认10,vpn默认5,vpngw默认2,vpcPeer默认50,firewall默认200,shareBandwidth默认5,shareBandwidthIP默认20

    min

    Integer

    允许修改的配额最小值

  • 响应样例
    {
        "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": "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
                }
            ]
        }
    }

状态码

请参见状态码

错误码

请参考错误码