Updated on 2026-09-23 GMT+08:00

Querying Tenant Resource Statistics

Function

Query tenant resource statistics.

Constraints

None

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    swr::getDomainResourceReports

    Read

    -

    -

    -

    -

URI

GET /v2/manage/reports/{resource_type}/{frequency}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

resource_type

Yes

String

Resource type.

Options:

  • store: tenant storage space

  • downflow: download traffic on the Internet

frequency

Yes

String

Frequency type.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). The value can be:

application/json;charset=utf-8

application/json

X-Auth-Token

Yes

String

User token.

You can obtain it by calling the IAM API for obtaining a user token. The token is the value of X-Subject-Token in the response header.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

[items]

Array of ReportData objects

Statistics.

Table 4 ReportData

Parameter

Type

Description

date

String

Time point.

value

Double

Statistical value.

Example Requests

GET https://{endpoint}/v2/reports/{resource_type}/{frequency}

Example Responses

Status code: 200

[ {
  "date" : "2024-09-01",
  "value" : 0
}, {
  "date" : "2024-09-02",
  "value" : 0
} ]

Status Codes

Status Code

Description

200

Tenant resource statistics have been obtained.

400

Request error.

401

Authorization failed.

500

Internal error.

Error Codes

See Error Codes.