Help Center/ Dedicated Host/ API Reference/ API/ Quota Configuration/ Querying the DeH Quota of a Tenant
Updated on 2024-04-16 GMT+08:00

Querying the DeH Quota of a Tenant

Function

This API is used to query the DeH quota of a tenant.

URI

GET /v1.0/{project_id}/quota-sets/{tenant_id}

Table 1 describes the parameters.

Table 1 Parameters description

Parameter

Type

Mandatory

Description

project_id

String

Yes

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

tenant_id

String

Yes

Specifies the tenant ID.

You can obtain the value from the DeH console or using the API in Querying DeHs.

Request

You can add the resource parameter to the URI. For example:

/v1.0/{project_id}/quota-sets/{tenant_id}?resource={resource}

Table 2 Request parameters

Parameter

Location

Type

Mandatory

Description

resource

query

String

No

Specifies the resource type.

Response

Table 3 Response parameters

Parameter

Type

Description

quota_set

Array of objects

Specifies the quota set of a DeH.

For details, see Table 4.

Table 4 quota_set field description

Parameter

Type

Description

resource

String

Specifies the resource type.

hard_limit

Integer

Specifies the quota limit.

-1 indicates that the resource quota is not limited.

used

Integer

Specifies the used amount of the quota.

Example Request

Query the DeH quota of the tenant whose ID is 45df5566cb3443ab910cf0daebcapoi8.

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/quota-sets/45df5566cb3443ab910cf0daebcapoi8

Example Response

{
 "quota_set": [
  {
   "used": 0,
   "resource": "c6",
   "hard_limit": 5
  },
  {
   "used": 0,
   "resource": "m6",
   "hard_limit": 5
  }]
}

Status Code

See Status Codes.