Querying Quotas

Function

This API is used to query the quotas of load balancers and related resources in a specific project. The API returns only the total quota, not the used quota. To query the used quota, you can call the API (GET /v3/{project_id}/elb/quotas/details) to query quota usage details.

Calling Method

For details, see Calling APIs.

URI

GET /v3/{project_id}/elb/quotas

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. Constraints: N/A Range: The value can contain a maximum of 32 characters, including digits and lowercase letters. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: Specifies the token used for IAM authentication. Constraints: N/A Range: N/A Default value: N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
request_id	String	Definition: Specifies the request ID. Range: The value is automatically generated, and can contain characters including digits, lowercase letters, and hyphens (-).
quota	Quota object	Definition: Specifies the quotas of load balancers and associated resources. Only the total quotas are returned. Remaining available quotas will not be returned.

**Table 4** Quota
Parameter	Type	Description
project_id	String	Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. Range: The value can contain a maximum of 32 characters, including digits and lowercase letters.
loadbalancer	Integer	Definition: Specifies the load balancer quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
certificate	Integer	Definition: Specifies the certificate quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
listener	Integer	Definition: Specifies the listener quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
l7policy	Integer	Definition: Specifies the forwarding policy quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
condition_per_policy	Integer	Definition: Specifies the maximum number of forwarding conditions per forwarding policy. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
pool	Integer	Definition: Specifies the backend server group quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
healthmonitor	Integer	Definition: Specifies the health check quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
member	Integer	Definition: Specifies the backend server quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
members_per_pool	Integer	Definition: Specifies the maximum number of backend servers in a backend server group. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
listeners_per_pool	Integer	Definition: Specifies the maximum number of listeners that can be associated with a backend server group. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
ipgroup	Integer	Definition: Specifies the IP address group quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
ipgroup_bindings	Integer	Definition: Specifies the maximum number of listeners that can be associated with an IP address group. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
ipgroup_max_length	Integer	Definition: Specifies the maximum number of IP entries that can be added to an IP address group. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
security_policy	Integer	Definition: Specifies the custom security policy quota. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
listeners_per_loadbalancer	Integer	Definition: Specifies the maximum number of listeners that can be associated with a load balancer. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited. NOTE: The maximum number of listeners that can be added to each load balancer is not limited, but it is recommended that the listeners not exceed the default quota.
ipgroups_per_listener	Integer	Definition: Specifies the maximum number of IP address groups that can be associated with a listener. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
pools_per_l7policy	Integer	Definition: Specifies the maximum number of backend server groups that can be associated with a forwarding policy. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
l7policies_per_listener	Integer	Definition: Specifies the maximum number of forwarding policies that can be associated with a listener. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
free_instance_members_per_pool	Integer	Definition: Specifies the maximum number of backend servers that can be added to a backend server group for free. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.
free_instance_listeners_per_loadbalancer	Integer	Definition: Specifies the maximum number of listeners that can be associated with a load balancer for free. Range: If the value is greater than or equal to 0, it indicates the current quota. -1 indicates that the quota is not limited.

Example Requests

Querying the quotas of resources associated with a load balancer

GET https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/quotas

Example Responses

Status code: 200

Successful request.

{
  "request_id" : "c6f3d7fe99bb1d8aa29e148097dab0d0",
  "quota" : {
    "member" : 10000,
    "members_per_pool" : 1000,
    "certificate" : -1,
    "l7policy" : 2000,
    "listener" : 1500,
    "loadbalancer" : 100000,
    "healthmonitor" : -1,
    "pool" : 5000,
    "ipgroup" : 1000,
    "ipgroup_bindings" : 50,
    "ipgroup_max_length" : 300,
    "security_policy" : 50,
    "project_id" : "060576798a80d5762fafc01a9b5eedc7",
    "condition_per_policy" : 10,
    "listeners_per_pool" : 50,
    "listeners_per_loadbalancer" : 50,
    "free_instance_members_per_pool" : 50,
    "free_instance_listeners_per_loadbalancer" : 10
  }
}

Status Codes

Status Code	Description
200	Successful request.

Error Codes

See Error Codes.

Parent Topic: Quota

Previous topic: Quota

Next topic: Querying Quota Usage

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.