更新时间:2026-04-24 GMT+08:00
分享

查询配额 - QueryQuotas

功能介绍

查询单租户在VPN服务下的网络资源配额,包括VPN网关配额、对端网关配额、VPN连接配额。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

vpn:connectionMonitors:delete

write

vpnConnections

-

-

URI

GET /v5/{project_id}/vpn/quotas
表1 参数说明

名称

类型

是否必选

说明

project_id

String

项目ID,可以通过获取项目ID获取项目ID。

请求消息

  • 请求参数

    无。

  • 请求样例
    GET https://{Endpoint}/v5/{project_id}/vpn/quotas

响应消息

  • 响应参数

    返回状态码为 200: 查询成功。

    表2 响应Body参数列表

    名称

    类型

    描述

    quotas

    Quotas object

    quotas对象。

    request_id

    String

    请求ID。

    表3 Quotas

    名称

    类型

    描述

    resources

    Array of QuotaInfo objects

    resources对象。

    表4 QuotaInfo

    名称

    类型

    描述

    type

    String

    • 功能说明:根据type过滤查询指定类型的配额。
    • 取值范围:
      • customer_gateway 企业版站点入云VPN对端网关。
      • vpn_connection 企业版站点入云VPN连接。
      • vpn_gateway 企业版站点入云VPN网关。
      • vpngw 经典版VPN网关。
      • vpn 经典版VPN连接。
      • vpn_gateway_local_subnet 企业版站点入云VPN网关单个网关的本端子网。
      • vpn_connection_peer_subnet 企业版站点入云VPN连接单个连接的对端子网。

    quota

    Integer

    配额上限。

    used

    Integer

    已使用数。

  • 响应样例
    {
        "quotas": {
            "resources": [
                {
                    "type": "customer_gateway",
                    "quota": 100,
                    "used": 13
                },
                {
                    "type": "vpn_connection",
                    "quota": 5000,
                    "used": 306
                },
                {
                    "type": "vpn_gateway",
                    "quota": 50,
                    "used": 23
                },
                {
                    "type": "vpn_gateway_local_subnet",
                    "quota": 50,
                    "used": 0
                },
                {
                    "type": "vpn_connection_peer_subnet",
                    "quota": 50,
                    "used": 0
                }
            ]
        },
        "request_id": "9aeb7f73-e1b6-42eb-96ad-b68aef8186e3"
    }

状态码

请参见状态码

相关文档