GetDomainRankingListData

Last updated:2021-07-20 11:45:43

GetDomainRankingListData

Description

You can call this operation to obtain the statistics data for all domain names of current account. The statistics data includes the traffic, traffic percentage, peak bandwidth, the time when bandwidth peaked, the number of requests for the domain name, and the percentage of the requests. The data can be sorted by traffic, peak bandwidth, or the number of requests.

  • You can query data by business type.
  • You can query data within the past year. The time granularity is one day.
  • Scenario:
    • Obtain the statistics data for all domain names of the current account. The statistics data includes the traffic, traffic percentage, peak bandwidth, the time when bandwidth peaked, the number of requests for the domain name, and the percentage of the requests. The data is sorted by traffic.

Request parameters

Parameter Required Type Description
StartTime Yes String The beginning of the time range to query. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm+0800 format. The time must be in UTC+8. Example: 2016-08-01T21:15+0800.
EndTime Yes String The end of the time range to query. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm+0800 format. The time must be in UTC+8. The end time must be later than the start time. Example: 2016-08-01T21:15+0800.
CdnType No String The business type. You can specify only one type at a time. Valid values: file, video, and page.
SortBy No String Specifies how the data is sorted. Valid values: bandwidth (sort by peak bandwidth), flow (sort by traffic) and pv (sort by the number of requests). Default value: flow.

Response parameters

Parameter Type Description
StartTime String The beginning of the time range that is queried.
EndTime String The end of the time range that is queried.
CdnType String The business type.
RequestId String The ID of the request. A unique request ID is returned for each request. The request ID is required for troubleshooting.
SortBy String Indicates how the data is sorted.
Datas DomainRankingList[] The statistics data, sorted in the specified order.

DomainRankingList

Parameter Type Description
Domain String The domain name.
Rank Long The ranking of the domain name.
Flow Long The sum of service traffic for the domain name in the specified time period.
FlowProportion Double The percentage of traffic for the domain name in all traffic in the specified time period.
Bw Long The peak bandwidth occurred in the specified time period.
PeakTime String The time when bandwidth peaked in the specified time period.
Pv Long The total number of requests for the domain name in the specified time period.
PvProportion Double The percentage of requests for the domain name in all requests in the specified time period.

Examples

Sample request

GET method:

GET /2020-06-30/statistics/GetDomainRankingListData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&CdnType=video&SortBy=flow
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainRankingListData
x-version: 2020-06-30

POST method:

POST /2020-06-30/statistics/GetDomainRankingListData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainRankingListData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime":"2020-09-01T08:00+0800",
    "EndTime":"2020-09-01T08:05+0800",
    "CdnType":"video",
    "SortBy":"flow"
}

Sample response

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "CdnType": "video",
    "SortBy": "flow",
    "Datas": [
        {
            "Domain": "www.test.com",
            "Rank": 1,
            "Flow": 257285,
            "FlowProportion": 3.0964726677548394E-4,
            "Bw": 6860,
            "PeakTime": "2020-09-01T08:00+0800",
            "Pv": 352,
            "PvProportion": 0.4077897102607769
        }
    ],
    "RequestId": "a1742346-233f-42c1-9be2-4255ca9deca0"
}

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈