doc-exports/docs/eip/api-ref/eip_apiquota_0001.html

Querying the Quota

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.

This API is used to query both the EIP and VPC quotas.

URI

GET /v1/{project_id}/quotas

Example:

GET https://{Endpoint}/v1/{project_id}/quotas?type={type}

Table 1 describes the parameters.

Table 1 Parameter description

Name	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.
type	No	String	Specifies the resource type. Values: vpc subnet securityGroup securityGroupRule publicIp vpn vpngw vpcPeer loadbalancer listener physicalConnect virtualInterface firewall shareBandwidthIP shareBandwidth address_group flow_log vpcContainRoutetable routetableContainRoutes

Request Message

• Request parameter

  None

• Example request

  GET https://{Endpoint}/v1/{project_id}/quotas

Response Message

• Response parameter

  Table 2 Response parameter

  Name	Type	Description
  quotas	quotas object	Specifies the quota object. For details, see Table 3.

  Table 3 Description of the quotas field

  Name	Type	Description
  resources	Array of resource objects	Specifies the resource objects. For details, see Table 4.

  Table 4 Description of the resource field

  Name	Type	Description
  type	String	Specifies the resource type. Values: vpc subnet securityGroup securityGroupRule publicIp vpn vpngw vpcPeer loadbalancer listener physicalConnect virtualInterface firewall shareBandwidthIP shareBandwidth address_group flow_log vpcContainRoutetable routetableContainRoutes
  used	Integer	Specifies the number of created network resources. The value ranges from 0 to the value of quota.
  quota	Integer	Specifies the maximum quota values for the resources. The value ranges from the default quota value to the maximum quota value. The default quota values can be changed. Configure the quota values in the underlying system in advance. Default quota values: VPC: 150 Subnet: 400 Security group: 100 Security group rule: 5000 EIPs: 10 VPNs: 5 VPC peering connections: 50 Load balancers: 10 Listeners: 10 Firewalls: 200 EIPs that can be added to a shared bandwidth: 20 Shared bandwidths: 5 IP address groups: 50 Route table per VPC: 1 Routes per route table: 200
  min	Integer	Specifies the minimum quota value allowed.

• 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
              }
          ]
      }
  }

Status Codes

See Status Codes.

Error Codes

See Error Codes.

Parent topic: Quota