Querying CDN Statistics

project_id

Yes

String

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

start_time

No

String

Start time. The format is yyyymmddhhmmss.

end_time

No

String

End time. The format is yyyymmddhhmmss.

• If neither start_time nor end_time is specified, start_time defaults to 00:00:00 of the current day, and end_time defaults to the current time.

• If end_time is specified but start_time is not, the request is invalid.

• If start_time is specified but end_time is not, end_time defaults to the current time.

• Only data from the past three months can be queried, and the time range cannot exceed 31 days.

• The start time and end time are automatically rounded. The start time is rounded down to the hour, while the end time is rounded up to the next hour.

stat_type

Yes

String

Statistics type.

The options include:

• cdn_bw: CDN peak bandwidth

• cdn_flux: CDN traffic

• req_num: number of requests

• req_hit_rate: request hit ratio

• flux_hit_rate: traffic hit ratio

Only one type of statistics can be queried at a time.

domain

Yes

String

Domain name list. Use commas (,) to separate domain names.

Example: example.test1.com,example.test2.com

ALL indicates that all domain names under a tenant are queried. A maximum of 100 domain names can be queried at a time.

interval

No

Integer

Query granularity.

The options include:

• For a time span of 1 day, the supported granularities are 300 seconds (5 minutes), 3,600 seconds (1 hour), 14,400 seconds (4 hours), and 28,800 seconds (8 hours).

• For a time span of 2 to 7 days, the supported granularities are 3,600 seconds (1 hour), 14,400 seconds (4 hours), 28,800 seconds (8 hours), and 86,400 seconds (1 day).

• For a time span of 8 to 31 days, the supported granularities are 14,400 seconds (4 hours), 28,800 seconds (8 hours), and 86,400 seconds (1 day).

Unit: second

If this parameter is not specified, the minimum granularity for the corresponding time span is used by default.

X-Auth-Token

No

String

User token. This parameter is mandatory when token authentication is used.

It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Authorization

No

String

Authentication information. This parameter is mandatory for AK/SK authentication.

X-Sdk-Date

No

String

Time when a request is sent. This parameter is mandatory for AK/SK authentication.

start_time

String

Start time for statistics collection.

interval

Integer

Statistics collection interval.

values

Array of longs

Sampled data array.

Sampling starts from start_time, and one data record will be collected at each interval (traffic unit: byte; bandwidth unit: bit/s).

error_code

String

Error code.

error_msg

String

Error description.

200

Returned when the request succeeded.

400

Returned when the request failed.