Queries the number of queries per second (QPS) for one or more specified accelerated domain names. The QPS data is collected every minute.
- You can query the data in the last seven days. The time range specified by the StartTime and EndTime parameters cannot exceed 24 hours for a single query.
- If StartTime is specified and EndTime is not specified, the data within the hour after the specified StartTime is returned.
- If EndTime is specified and StartTime is not specified, the data within the hour before the EndTime is returned.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDcdnDomainRealTimeQpsData |
The operation that you want to perform. Set the value to DescribeDcdnDomainRealTimeQpsData. |
DomainName | String | Yes | example.com |
The accelerated domain name. Separate multiple domain names with commas (,). |
IspNameEn | String | No | telecom |
The name of the Internet service provider (ISP). If you do not set this parameter, all ISPs are queried. You can call the DescribeDcdnRegionAndIsp operation to query ISP names. |
LocationNameEn | String | No | beijing |
The name of the region. If you do not set this parameter, all regions are queried. You can call the DescribeDcdnRegionAndIsp operation to query region names. |
StartTime | String | No | 2018-01-02T11:26:00Z |
The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
EndTime | String | No | 2018-01-02T11:27:00Z |
The end time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Note The end time must be later than the start time.
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Data | Array of QpsModel |
The list of the returned data. |
|
QpsModel | |||
Qps | Float | 1851.25 |
The QPS data. |
TimeStamp | String | 2018-01-02T11:26:00Z |
The timestamp of the data returned. The time follows the ISO 8601 standard. The time is displayed in UTC. |
RequestId | String | 32DC9806-E9F9-4490-BBDC-B3A9E32FCC1D |
The ID of the request. |
Examples
Sample requests
http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainRealTimeQpsData
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML
format
<DescribeDcdnDomainRealTimeQpsDataResponse>
<Data>
<QpsModel>
<TimeStamp>2018-01-02T11:26:00Z</TimeStamp>
<Qps>1851.25</Qps>
</QpsModel>
<QpsModel>
<TimeStamp>2018-01-02T11:25:00Z</TimeStamp>
<Qps>8967.7</Qps>
</QpsModel>
</Data>
<RequestId>32DC9806-E9F9-4490-BBDC-B3A9E32FCC1D</RequestId>
</DescribeDcdnDomainRealTimeQpsDataResponse>
JSON
format
{
"Data":{
"QpsModel":[
{
"TimeStamp":"2018-01-02T11:26:00Z",
"Qps":1851.25
},
{
"TimeStamp":"2018-01-02T11:25:00Z",
"Qps":8967.7
}
]
},
"RequestId":"32DC9806-E9F9-4490-BBDC-B3A9E32FCC1D"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | The error message returned because the StartTime and EndTime parameters must be set. |
400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | The error message returned because the format of the specified end time is invalid. Specify the value in a valid format. Specify the time in the ISO 8601 standard in yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | The error message returned because the end time is earlier than the start time. |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | The error message returned because the specified start time is invalid. Specify a valid value. |
For a list of error codes, visit the API Error Center.