Querying Quotas¶
Function¶
This API is used to query network resource quotas of a tenant. The network resources include VPCs, subnets, security groups, security group rules, EIPs, and VPNs.
URI¶
GET /v1/{project_id}/quotas
Example:
GET https://{Endpoint}/v1/{project_id}/quotas?type={type}
Table 1 describes the parameters.
Name | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
type | No | String |
|
Request Parameters¶
None
Example Request¶
GET https://{Endpoint}/v1/{project_id}/quotas
Response Parameters¶
Name | Type | Description |
---|---|---|
resources | Array of resource objects | Specifies the resource objects. For details, see Table 4. |
Name | Type | Description |
---|---|---|
type | String |
|
used | Integer |
|
quota | Integer |
|
min | Integer | Specifies the minimum quota value allowed. |
Note
If value -1 is returned when you use an API to query your VPC quota, this indicates that the VPC quota is not limited.
Example Response¶
{
"quotas": {
"resources": [
{
"type": "vpc",
"used": 4,
"quota": 150,
"min": 0
},
{
"type": "subnet",
"used": 5,
"quota": 400,
"min": 0
},
{
"type": "securityGroup",
"used": 1,
"quota": 100,
"min": 0
},
{
"type": "securityGroupRule",
"used": 6,
"quota": 5000,
"min": 0
},
{
"type": "publicIp",
"used": 2,
"quota": 10,
"min": 0
},
{
"type": "vpn",
"used": 0,
"quota": 5,
"min": 0
},
{
"type": "vpcPeer",
"used": 0,
"quota": 50,
"min": 0
},
{
"type": "firewall",
"used": 0,
"quota": 200,
"min": 0
},
{
"type": "shareBandwidth",
"used": 0,
"quota": 5,
"min": 0
},
{
"type": "shareBandwidthIP",
"used": 0,
"quota": 20,
"min": 0
},
{
"type": "loadbalancer",
"used": 0,
"quota": 10,
"min": 0
},
{
"type": "listener",
"used": 0,
"quota": 10,
"min": 0
},
{
"type": "vpcContainRoutetable",
"used": 0,
"quota": 1,
"min": 0
},
{
"type": "routetableContainRoutes",
"used": 0,
"quota": 200,
"min": 0
}
]
}
}
Status Code¶
See Status Codes.
Error Code¶
See Error Codes.