Updated on 2022-02-22 GMT+08:00

Querying the Tracker Quota of a Tenant

Function

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

URI

GET /v3/{project_id}/quotas

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Identifies a project. For details, see section "Obtaining the Account ID and Project ID" in Cloud Trace Service API Reference.

Request Parameters

None

Response Parameters

If a status code 200is returned, see the parameters in the following tables.

Table 2 Response body parameters

Parameter

Type

Description

resources

Array of Quota objects

Indicates a list of tracker quota information.

Table 3 Quota

Parameter

Type

Description

type

String

Indicates the resource type.

used

Long

Indicates the number of used resources.

quota

Long

Indicates the total number of resources.

If a status code 400is returned, see the parameters in the following tables.

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Indicates an error code, in the format of CTS.XXX.

error_msg

String

Indicates the error description.

Request Examples

GET https://{endpoint}/v3/{project_id}/quotas

Response Examples

Status code: 200

The request is successful.

{
  "resources" : [ {
    "type" : "data_tracker",
    "used" : 9,
    "quota" : 100
  }, {
    "type" : "system_tracker",
    "used" : 1,
    "quota" : 1
  } ]
}

Status Codes

Status Code

Description

200

The request is successful.

400

The server failed to process the request.

401

The request is rejected due to authentication failure.

403

The server understood the request but refused to authorize it.

404

The requested resource does not exist.

500

The server has received the request but encountered an internal error.

503

The requested service is unavailable. The client should not repeat the request without modifications.

Error Codes

See Error Codes.