Release Notes
Announcements
Domain name for API request: cdn.intl.tencentcloudapi.com.
This API is used to query the daily/weekly/monthly report data at domain name/project levels.
A maximum of 10 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeReportData. |
| Version | Yes | String | Common Params. The value used for this API: 2018-06-06. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| StartTime | Yes | Date | Query the start time in the format of yyyy-MM-ddIf the report type is daily, the start time and end time must be of the same day.If the report type is weekly, the start time must be Monday and the end time must be the Sunday of the same week.If the report type is monthly, the start time must be the first day of the month and the end time must be the last day of the same month. |
| EndTime | Yes | Date | Query the end time in the format of yyyy-MM-ddIf the report type is daily, the start time and end time must be of the same day.If the report type is weekly, the start time must be Monday and the end time must be the Sunday of the same week.If the report type is monthly, the start time must be the first day of the month and the end time must be the last day of the same month. |
| ReportType | Yes | String | Report type daily: daily report weekly: weekly report (Monday to Sunday) monthly: monthly report (calendar month) |
| Area | Yes | String | Domain name acceleration regionmainland: Regions within the Chinese mainlandoverseas: Regions outside the Chinese mainland |
| Offset | No | Integer | Offset. Default value: 0. |
| Limit | No | Integer | Number of data entries. Default value: 1000. |
| Project | No | Integer | Filters by project ID |
| Parameter Name | Type | Description |
|---|---|---|
| DomainReport | Array of ReportData | Domain name-level data details. |
| ProjectReport | Array of ReportData | Project-level data details |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
https://cdn.intl.tencentcloudapi.com/?Action=DescribeReportData
&StartTime=2020-02-01
&EndTime=2020-02-29
&ReportType=monthly
&Area=mainland
&<Common request parameters>{
"Response": {
"RequestId": "8aa8eb8d-d704-45a9-ae81-9606243193cb",
"DomainReport": [
{
"Resource": "www.test1.com",
"ResourceId": "cdn-8km12345",
"Value": 100,
"Percentage": 50,
"BillingValue": 100,
"BillingPercentage": 50
},
{
"Resource": "www.test2.com",
"ResourceId": "cdn-rl523456",
"Value": 100,
"Percentage": 50,
"BillingValue": 100,
"BillingPercentage": 50
}
],
"ProjectReport": [
{
"Resource": "p1",
"ResourceId": "123",
"Value": 100,
"Percentage": 10,
"BillingValue": 100,
"BillingPercentage": 10
},
{
"Resource": "Default Project",
"ResourceId": "0",
"Value": 900,
"Percentage": 90,
"BillingValue": 900,
"BillingPercentage": 90
}
]
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| InternalError.CdnDbError | Internal data error. Please submit a ticket for troubleshooting. |
| InternalError.CdnSystemError | System error. Please submit a ticket for troubleshooting. |
| InternalError.Error | Service internal error. Please submit a ticket for troubleshooting. |
| InternalError.InvalidErrorCode | Service internal error. Please submit a ticket for troubleshooting. |
| InvalidParameter.CdnParamError | Parameter error. Please see the sample parameters in the documentation. |
| ResourceNotFound.CdnUserNotExists | The CDN service has not been activated. Please activate it first before using this API. |
| UnauthorizedOperation.CdnCamUnauthorized | No CAM policy is configured for the sub-account. |
| UnauthorizedOperation.OpNoAuth | This operation is not supported currently. Please submit a ticket for assistance. |
| UnauthorizedOperation.OperationTooOften | Too many calling attempts. |
| UnsupportedOperation.OpNoAuth | This operation is not supported currently. Please submit a ticket for assistance. |
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback