查询配额 - ShowQuota
功能介绍
您可以通过此接口查询VPC服务相关资源的配额,包括安全组配额、安全组规则配额等。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
vpc:quotas:list
List
-
-
vpc:quotas:get
-
URI
GET /v3/{project_id}/vpc/quotas
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 网络ACL所属的项目ID。获取方式请参见获取项目ID。 取值范围: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| quota | VpcQuotas object | 参数解释: 查询配额的响应体。 取值范围: 不涉及。 |
| request_id | String | 参数解释: 请求ID。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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操作正常返回,更多状态码请参见状态码。 |
错误码
请参见错误码。