Updated on 2025-08-13 GMT+08:00

Querying Quotas

Function

This API is used to query resource quotas, for example, how many connections and virtual interfaces have been created.

Debugging

For details, see Calling APIs.

URI

GET /v3/{project_id}/dcaas/quotas

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

Table 2 Query parameters

Parameter

Mandatory

Type

Description

type

No

Array

Specifies resource quotas.

  • - physicalConnect: connection quota and used quota
  • - virtualInterface: virtual-interface quota and used quota

Request Parameters

None

Response Parameters

Status code: 201

Table 3 Response body parameters

Parameter

Type

Description

quotas

quotas object

Provides used quota details.

Table 4 quotas

Parameter

Type

Description

resources

Array of Info objects

Specifies the used resource quotas.

Table 5 Info

Parameter

Type

Description

type

String

Specifies the quota type.

quota

Long

Specifies the available quota. The value -1 indicates that there is no quota limit.

used

Long

Specifies the used quota.

unit

String

Specifies the measurement unit of resource usage.

Example Requests

Querying quotas

GET https://{dc_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/dcaas/quotas

Example Responses

Status code: 201

Quotas are queried.

{
  "quotas" : {
    "resources" : [ {
      "type" : "direct_connect",
      "quota" : 1,
      "used" : 0,
      "unit" : "count"
    } ]
  }
}

Status Code

Status Code

Description

201

Quotas are queried.

Error Codes

See Error Codes.