Document Center

DescribeDomainISPData

Last Updated: Apr 02, 2018

Description

  • Obtain the distribution of users and carriers of CDN domain names with day granularity.

  • When StartTime and EndTime are not specified, the system reads data from the past 24 hours by default. Query by specified start time and end time is also supported. The two parameters must be both specified.

    • The system supports query of only one domain name or all domain names belonging to the current user.

    • Data from the past 90 days can be obtained at most.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeDomainISPData

The name of this interface. Value: DescribeDomainISPData
DomainName String No test.test.com

CDN domain name to be queried. This parameter can be set to support only one domain name. If this parameter is left blank, all domain names belonging to the current user are queried.
EndTime String No 2015-12-05

  • The end time must be later than the start time, and adopts Beijing time.
  • Format: YYYY-MM-DD.
StartTime String No 2015-12-05

  • Start time of data query, and adopts Beijing time.
  • Format: YYYY-MM-DD.
  • If this parameter is unspecified, data from the past 24 hours is read by default.

Return parameters

Parameters Type Example values Description
RequestId String DE81639B-DAC1-4C76-AB72-F34B836837D5

The ID of the request.

DomainName String test.test.com

The CDN domain name.

DataInterval String 86400

Time interval.

StartTime String 2016-03-14

Start time of data query.

EndTime String 2016-03-14

End time of data query.

Value

List of access proportion data of each carrier.

  └ISP String Alibaba

Carrier information.

  └Proportion String 0.004509176173513099

Proportion data.

  └IspEname String alibaba

Carrier name in English.

  └AvgObjectSize String 7081884.7

Average response size. Unit: bytes.

  └AvgResponseTime String 79638.0

Average response time. Unit: milliseconds.

  └Bps String 1311.4601296296296

Bandwidth.

  └ByteHitRate String 100.0

Bytes hit rate.

  └Qps String 2.3148148148148147E-5

Per-second query rate.

  └ReqErrRate String 0.0

Request error rate.

  └ReqHitRate String 100.0

Request hit rate.

  └AvgResponseRate String 88.92594866772144

Average response speed. Unit: bytes/ms.

  └TotalBytes String 7081884

Total traffic.

  └BytesProportion String 0.012220518530445479

Total traffic proportion.

  └TotalQuery String 1

Total number of requests.

Example

Request example

  1. http://cdn.aliyuncs.com?Action=DescribeDomainISPData&DomainName=test.com
  2. &StartTime=2015-12-05
  3. &EndTime=2015-12-07
  4. &<public request parameter>

Normal return example

JSON format

  1. {
  2.     "DataInterval":"86400",
  3.     "DomainName":"downtest.cdnpe.com",
  4.     "EndTime":"2016-03-14",
  5.     "RequestId":"DE81639B-DAC1-4C76-AB72-F34B836837D5",
  6.     "StartTime":"2016-03-13",
  7.     "Value":{
  8.         "ISPProportionData":[
  9.             {
  10.                 "AvgObjectSize":"7081884.7",
  11.                 "AvgResponseRate":"88.92594866772144",
  12.                 "AvgResponseTime":"79638.0",
  13.                 "Bps":"1311.4601296296296",
  14.                 "ByteHitRate":"100.0",
  15.                 "BytesProportion":"0.012220518530445479",
  16.                 "ISP":"Alibaba",
  17.                 "IspEname":"alibaba",
  18.                 "Proportion":"0.004509176173513099",
  19.                 "Qps":"2.3148148148148147E-5",
  20.                 "ReqErrRate":"0.0",
  21.                 "ReqHitRate":"100.0",
  22.                 "TotalBytes":"7081884",
  23.                 "TotalQuery":"1"
  24.             },
  25.             {
  26.                 "AvgObjectSize":"800019.0",
  27.                 "AvgResponseRate":"154.3345765545624",
  28.                 "AvgResponseTime":"5183.666666666667",
  29.                 "Bps":"444.455",
  30.                 "ByteHitRate":"100.0",
  31.                 "BytesProportion":"0.004141544558417533",
  32.                 "ISP":"overseas ISP",
  33.                 "IspEname":"overseas",
  34.                 "Proportion":"0.013527528520539298",
  35.                 "Qps":"6.944444444444444E-5",
  36.                 "ReqErrRate":"0.0",
  37.                 "ReqHitRate":"100.0",
  38.                 "TotalBytes":"2400057",
  39.                 "TotalQuery":"3"
  40.             },
  41.             {
  42.                 "AvgObjectSize":"3018642.684146342",
  43.                 "AvgResponseRate":"1025.5028528460102",
  44.                 "AvgResponseTime":"2943.5731707317073",
  45.                 "Bps":"45838.64816666667",
  46.                 "ByteHitRate":"100.0",
  47.                 "BytesProportion":"0.42713616424581613",
  48.                 "ISP":"Dr PENG",
  49.                 "IspEname":"drpeng",
  50.                 "Proportion":"0.3697524462280741",
  51.                 "Qps":"0.0018981481481481482",
  52.                 "ReqErrRate":"0.0",
  53.                 "ReqHitRate":"100.0",
  54.                 "TotalBytes":"247528700",
  55.                 "TotalQuery":"82"
  56.             },
  57.             {
  58.                 "AvgObjectSize":"3123166.4508771934",
  59.                 "AvgResponseRate":"484.6396117340071",
  60.                 "AvgResponseTime":"6444.30701754386",
  61.                 "Bps":"65933.51396296297",
  62.                 "ByteHitRate":"99.99999999999999",
  63.                 "BytesProportion":"0.6143852267848392",
  64.                 "ISP":"CERNET",
  65.                 "IspEname":"cernet",
  66.                 "Proportion":"0.5140460837804933",
  67.                 "Qps":"0.002638888888888889",
  68.                 "ReqErrRate":"0.0",
  69.                 "ReqHitRate":"100.0",
  70.                 "TotalBytes":"356040975",
  71.                 "TotalQuery":"114"
  72.             },
  73.             {
  74.                 "AvgObjectSize":"2116401.843961353",
  75.                 "AvgResponseRate":"752.2096624205244",
  76.                 "AvgResponseTime":"2813.5797101449275",
  77.                 "Bps":"81128.73735185186",
  78.                 "ByteHitRate":"100.0",
  79.                 "BytesProportion":"0.7559781771177001",
  80.                 "ISP":"Tie Tong",
  81.                 "IspEname":"tietong",
  82.                 "Proportion":"0.9333994679172115",
  83.                 "Qps":"0.004791666666666666",
  84.                 "ReqErrRate":"0.0",
  85.                 "ReqHitRate":"100.0",
  86.                 "TotalBytes":"438095181",
  87.                 "TotalQuery":"207"
  88.             },
  89.             {
  90.                 "AvgObjectSize":"2723991.4195312504",
  91.                 "AvgResponseRate":"321.5924922592767",
  92.                 "AvgResponseTime":"8470.3203125",
  93.                 "Bps":"129137.37100000001",
  94.                 "ByteHitRate":"100.00000000000001",
  95.                 "BytesProportion":"1.2033348171432345",
  96.                 "ISP":"Other",
  97.                 "IspEname":"other",
  98.                 "Proportion":"1.1543491004193533",
  99.                 "Qps":"0.005925925925925926",
  100.                 "ReqErrRate":"0.0",
  101.                 "ReqHitRate":"100.0",
  102.                 "TotalBytes":"697341803",
  103.                 "TotalQuery":"256"
  104.             },
  105.             {
  106.                 "AvgObjectSize":"1657975.598360084",
  107.                 "AvgResponseRate":"1004.5513789924338",
  108.                 "AvgResponseTime":"1650.463712491277",
  109.                 "Bps":"879955.1972037038",
  110.                 "ByteHitRate":"99.14745652563326",
  111.                 "BytesProportion":"8.19964599032574",
  112.                 "ISP":"Mobile",
  113.                 "IspEname":"mobile",
  114.                 "Proportion":"12.923298913288543",
  115.                 "Qps":"0.06634259259259259",
  116.                 "ReqErrRate":"0.0",
  117.                 "ReqHitRate":"97.3831123517097",
  118.                 "TotalBytes":"4751758064",
  119.                 "TotalQuery":"2866"
  120.             },
  121.             {
  122.                 "AvgObjectSize":"2640215.374074074",
  123.                 "AvgResponseRate":"1171.525957981939",
  124.                 "AvgResponseTime":"2253.6550352004897",
  125.                 "Bps":"3194660.60262963",
  126.                 "ByteHitRate":"99.99981717005271",
  127.                 "BytesProportion":"29.768658772680293",
  128.                 "ISP":"Unicom",
  129.                 "IspEname":"unicom",
  130.                 "Proportion":"29.46295711773459",
  131.                 "Qps":"0.15125",
  132.                 "ReqErrRate":"0.0",
  133.                 "ReqHitRate":"99.96939087848179",
  134.                 "TotalBytes":"17251167254",
  135.                 "TotalQuery":"6534"
  136.             },
  137.             {
  138.                 "AvgObjectSize":"2823126.71357933",
  139.                 "AvgResponseRate":"984.184264638081",
  140.                 "AvgResponseTime":"2868.494056463596",
  141.                 "Bps":"6333214.260796296",
  142.                 "ByteHitRate":"99.99968869093071",
  143.                 "BytesProportion":"59.01449878861353",
  144.                 "ISP":"Telecom",
  145.                 "IspEname":"telecom",
  146.                 "Proportion":"54.62416016593768",
  147.                 "Qps":"0.28041666666666665",
  148.                 "ReqErrRate":"0.0",
  149.                 "ReqHitRate":"99.97523526498266",
  150.                 "TotalBytes":"34199357008",
  151.                 "TotalQuery":"12114"
  152.             }
  153.         ]
  154.     }
  155. }

Exception return example

JSON format 

  1. {
  2.     "Code":"InternalError",
  3.     "HostId":"cdn.aliyuncs.com",
  4.     "Message":"The request processing has failed due to some unknown error.",
  5.     "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

Error code

For more information, see Error code of this product.

Thank you! We've received your feedback.
Free Trial Free Trial