文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 配额/ 查询配额 - ShowQuota
更新时间:2026-07-03 GMT+08:00
分享

查询配额 - ShowQuota

功能介绍

您可以通过此接口查询VPC服务相关资源的配额,包括安全组配额、安全组规则配额等。

调用方法

请参见如何调用API

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    vpc:quotas:list

    List

    -

    -

    vpc:quotas:get

    -

URI

GET /v3/{project_id}/vpc/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

网络ACL所属的项目ID。获取方式请参见获取项目ID

取值范围

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

quota

VpcQuotas object

参数解释

查询配额的响应体。

取值范围

不涉及。

request_id

String

参数解释

请求ID。

取值范围

不涉及。

表3 VpcQuotas

参数

参数类型

描述

acl_policy_contain_rules

Integer

参数解释

网络ACL单方向规则数配额。

取值范围

整数,-1表示此配额未上线。

address_group

Integer

参数解释

IP地址组数配额。

取值范围

整数,-1表示此配额未上线。

address_group_contain_ipset

Integer

参数解释

IP地址组包含的IP地址集数配额。

取值范围

整数,-1表示此配额未上线。

edge_gateway

Integer

参数解释

边缘网关数配额。

取值范围

整数,-1表示此配额未上线。

eni_contain_secgroup

Integer

参数解释

弹性网卡关联的安全组数配额。

取值范围

整数,-1表示此配额未上线。

firewall_policy_contain_ipv4_composite_rules

Integer

参数解释

网络ACL中配置了IP地址组或不连续端口的IPv4规则数配额。

取值范围

整数,-1表示此配额未上线。

firewall_policy_contain_ipv6_composite_rules

Integer

参数解释

网络ACL中配置了IP地址组或不连续端口的IPv6规则数配额。

取值范围

整数,-1表示此配额未上线。

peering

Integer

参数解释

对等连接数配额。

取值范围

整数,-1表示此配额未上线。

secgroup_contain_rules

Integer

参数解释

单个安全组包含的规则数配额。

取值范围

整数,-1表示此配额未上线。

secgroup_referred_by_nic

Integer

参数解释

单个安全组关联的网卡数配额。

取值范围

整数,-1表示此配额未上线。

security_group

Integer

参数解释

安全组数配额。

取值范围

整数,-1表示此配额未上线。

security_group_contain_egress_ipv4_composite_rules

Integer

参数解释

安全组中配置了IP地址组、不连续端口或远端安全组的IPv4出方向规则数配额。

取值范围

整数,-1表示此配额未上线。

security_group_contain_egress_ipv6_composite_rules

Integer

参数解释

安全组中配置了IP地址组、不连续端口或远端安全组的IPv6出方向规则数配。

取值范围

整数,-1表示此配额未上线。

security_group_contain_ingress_ipv4_composite_rules

Integer

参数解释

安全组中配置了IP地址组、不连续端口或远端安全组的IPv4入方向规则数配额。

取值范围

整数,-1表示此配额未上线。

security_group_contain_ingress_ipv6_composite_rules

Integer

参数解释

安全组中配置了IP地址组、不连续端口或远端安全组的IPv6入方向规则数配额。

取值范围

整数,-1表示此配额未上线。

security_group_rule

Integer

参数解释

安全组规则数配额。

取值范围

整数,-1表示此配额未上线。

subnet_contain_eni

Integer

参数解释

单个子网包含的弹性网卡数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_filter

Integer

参数解释

流量镜像筛选条件数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_filter_referred_by_session

Integer

参数解释

单个流量镜像筛选条件被镜像会话引用数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_filter_contain_rules_each_direction

Integer

参数解释

流量镜像筛选条件单方向规则数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_session

Integer

参数解释

流量镜像会话数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_session_contain_sources

Integer

参数解释

单个流量镜像会话关联的镜像源数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_source_referred_by_session

Integer

参数解释

单个镜像源被流量镜像会话引用次数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_target_elb_referred_by_session

Integer

参数解释

私网弹性负载均衡类型的镜像目的被会话引用次数配额。

取值范围

整数,-1表示此配额未上线。

traffic_mirror_target_eni_referred_by_session

Integer

参数解释

弹性网卡类型的镜像目的被会话引用次数配额。

取值范围

整数,-1表示此配额未上线。

vip

Integer

参数解释

虚拟IP数配额。

取值范围

整数,-1表示此配额未上线。

virsubnet

Integer

参数解释

子网数配额。

取值范围

整数,-1表示此配额未上线,请通过v1查询配额接口

virsubnet_contain_ipv4_cidr_reservations

Integer

参数解释

单子网包含IPv4子网预留网段数配额。

取值范围

整数,-1表示此配额未上线。

virsubnet_contain_ipv6_cidr_reservations

Integer

参数解释

单子网包含IPv6子网预留网段数配额。

取值范围

整数,-1表示此配额未上线。

vpc

Integer

参数解释

VPC数配额。

取值范围

整数,-1表示此配额未上线,请通过v1查询配额接口

vpc_contain_eni

Integer

参数解释

单个VPC包含弹性网卡数配额。

取值范围

整数,-1表示此配额未上线。

vpc_contain_vip

Integer

参数解释

单个VPC包含虚拟IP数配额。

取值范围

整数,-1表示此配额未上线。

vpc_contain_virsubnet

Integer

参数解释

单个VPC包含子网数配额。

取值范围

整数,-1表示此配额未上线。

请求示例

查询配额。

GET https://{Endpoint}/v3/{project_id}/vpc/quotas

响应示例

状态码:200

GET操作正常返回,更多状态码请参见状态码

{
  "quota" : {
    "vpc" : -1,
    "security_group" : 100,
    "security_group_rule" : 5000,
    "peering" : 50,
    "address_group" : 50,
    "address_group_contain_ipset" : 100,
    "vpc_contain_virsubnet" : -1,
    "secgroup_referred_by_nic" : 50000,
    "secgroup_contain_rules" : 50,
    "vpc_contain_eni" : -1,
    "eni_contain_secgroup" : -1,
    "acl_policy_contain_rules" : 40,
    "vip" : 10,
    "edge_gateway" : 3,
    "vpc_contain_vip" : -1,
    "subnet_contain_eni" : -1,
    "traffic_mirror_session" : 20000,
    "traffic_mirror_filter" : 2000,
    "traffic_mirror_filter_referred_by_session" : 1000,
    "traffic_mirror_filter_contain_rules_each_direction" : 10,
    "traffic_mirror_target_elb_referred_by_session" : 200,
    "traffic_mirror_target_eni_referred_by_session" : 10,
    "traffic_mirror_source_referred_by_session" : 3,
    "traffic_mirror_session_contain_sources" : 10,
    "security_group_contain_ingress_ipv4_composite_rules" : 120,
    "security_group_contain_ingress_ipv6_composite_rules" : 120,
    "security_group_contain_egress_ipv4_composite_rules" : 120,
    "security_group_contain_egress_ipv6_composite_rules" : 120,
    "firewall_policy_contain_ipv4_composite_rules" : 120,
    "firewall_policy_contain_ipv6_composite_rules" : 120,
    "virsubnet_contain_ipv4_cidr_reservations" : 10,
    "virsubnet_contain_ipv6_cidr_reservations" : 10,
    "virsubnet" : -1
  },
  "request_id" : "c36874fe67538207eff03797e6a50734"
}

SDK代码示例

SDK代码示例如下。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.vpc.v3.region.VpcRegion;
import com.huaweicloud.sdk.vpc.v3.*;
import com.huaweicloud.sdk.vpc.v3.model.*;


public class ShowQuotaSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        VpcClient client = VpcClient.newBuilder()
                .withCredential(auth)
                .withRegion(VpcRegion.valueOf("<YOUR REGION>"))
                .build();
        ShowQuotaRequest request = new ShowQuotaRequest();
        try {
            ShowQuotaResponse response = client.showQuota(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkvpc.v3.region.vpc_region import VpcRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkvpc.v3 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = VpcClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(VpcRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ShowQuotaRequest()
        response = client.show_quota(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    vpc "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpc/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpc/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpc/v3/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := vpc.VpcClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := vpc.NewVpcClient(hcClient)

    request := &model.ShowQuotaRequest{}
	response, err := client.ShowQuota(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

GET操作正常返回,更多状态码请参见状态码

错误码

请参见错误码

相关文档