文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 配额/ 查询配额 - ShowQuota
更新时间:2025-12-23 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"
}

状态码

状态码

描述

200

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

错误码

请参见错误码