Domain name for API request: alb.intl.tencentcloudapi.com.
Queries the ALB quota configuration of the current account. It supports querying by quota type and allows you to pass a resource ID to query resource-level quotas. You can use DisplayFields to return the used amount and remaining available quantity as needed.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeQuota. |
| Version | Yes | String | Common Params. The value used for this API: 2025-10-30. |
| Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
| QuotaTypes.N | Yes | Array of String | List of quota types. Supports inputting multiple quota types at the same time. When querying resource-level quotas, can be used in conjunction with ResourceIds to input the corresponding resource IDs. To return the used amount and available amount, input used and available in DisplayFields. Enumeration description: - alb_quota_loadbalancers_num: Number of ALB instances creatable per region. - alb_quota_targetgroups_num: Number of ALB target groups creatable per region. -alb_quota_loadbalancer_listeners_num: Number of listeners creatable for each ALB instance. For ResourceIds, fill in the ALB instance ID. -alb_quota_loadbalancer_rules_num: Number of forwarding rules that can be added to each ALB instance, excluding the default rule. For ResourceIds, fill in the ALB instance ID. -alb_quota_loadbalancer_certificates_num: Number of additional certificates that can be added to each ALB instance, excluding the default certificate. For ResourceIds, fill in the ALB instance ID. -alb_quota_loadbalancer_targetgroup_num: The number of target groups that can be bound to each ALB instance. Fill in the ALB instance ID in ResourceIds. -alb_quota_loadbalancer_servers_num: Number of real servers that can be added to each ALB instance. For ResourceIds, fill in the ALB instance ID. -alb_quota_server_added_num: Number of times one real server IP can be added to an ALB backend target group. -alb_quota_targetgroup_attached_num: The number of times each target group can be associated with ALB forwarding rules. Fill in the target group ID in ResourceIds. -alb_quota_targetgroup_targets_num: Number of real servers supported by each target group. It is applicable to IP and port type backends. For ResourceIds, fill in the target group ID. -alb_quota_targetgroup_targets_num_scf: Number of SCF function backends supported by each target group. For ResourceIds, fill in the target group ID. -alb_quota_max_request_timeout: Maximum timeout time configurable for a connection request when a listener is created. -alb_quota_max_idle_timeout: Maximum idle timeout that can be configured for a connection when a listener is created. -alb_quota_listener_certificates_num: Number of certificates that can be added to each listener. For ResourceIds, fill in the listener ID. -alb_quota_rule_targetgroups_num: Number of target groups that can be bound to a forwarding rule. -alb_quota_rule_conditions_num: Number of match conditions that can be added to a forwarding rule. -alb_quota_rule_wildcards_num: Number of match entries containing wildcards that can be added to a single forwarding rule. -alb_quota_rule_actions_num: Number of action entries that can be added to a single forwarding rule. -alb_quota_cipher_template_listeners_num: Number of listeners that can be associated with each encryption suite template. -alb_quota_healthcheck_templates_num: Number of health check templates that can be created per region. -alb_quota_securitygroup_templates_num: Number of security groups that can be bound to one ALB instance. -alb_quota_securitygroup_rules_per_sg_num: Number of rule entries supported by one security group in one ALB instance. -alb_quota_security_policies_num: Number of custom security policies creatable per region. |
| DisplayFields.N | No | Array of String | Field display list used to control whether to additionally return usage information. Supports used and available: used means to return the currently used amount, and available means to return the current remaining available amount. QuotaType and Limit are always returned. ResourceId will be returned when ResourceIds are input in the request. |
| ResourceIds.N | No | Array of String | Resource ID list. Used for querying the quota and amount at the specific resource dimension. If not specified, the default quota configuration at the account or region level is queried. The type of resource ID is determined by QuotaTypes. For example, for ALB instance-level quotas, fill in the ALB instance ID; for listener-level quotas, fill in the listener ID; for target group-level quotas, fill in the target group ID. |
| Parameter Name | Type | Description |
|---|---|---|
| Quotas | Array of QuotaInfo | Quota list. Each element represents the query result of a quota type. When ResourceIds is input in the request, each element represents the query result of a composite of a quota type and a resource ID. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: alb.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeQuota
<Common request parameters>
{
"QuotaTypes": [
"alb_quota_loadbalancers_num"
]
}{
"Response": {
"Quotas": [
{
"Available": null,
"Limit": 60,
"QuotaType": "alb_quota_loadbalancers_num",
"ResourceId": "alblcu-e8p3x9mq",
"Used": null
}
],
"RequestId": "c6585b63-353a-48cb-93ec-b23321e3b7ea"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
There is no error code related to the API business logic. For other error codes, please see Common Error Codes.
フィードバック