調用DescribeDomainISPData查詢加速網域名稱天粒度的使用者電訊廠商分布資料統計,支援擷取最近90天的資料。
说明
- 如果您不指定StartTime和EndTime時,該介面返回過去24小時的資料;指定StartTime和EndTime時,返回起止時間的資料。
- 該介面只支援擷取一個網域名稱或當前賬戶下所有網域名稱的資料。
- 單使用者調用頻率:100次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
|---|---|---|---|---|
| Action | String | 否 | DescribeDomainISPData |
系統規定參數。取值:DescribeDomainISPData。 |
| DomainName | String | 否 | example.com |
加速網域名稱,僅支援查詢單個網域名稱。 預設查詢所有加速網域名稱。 |
| StartTime | String | 否 | 2019-11-29T05:33:00Z |
擷取資料起始時間點。日期格式按照ISO8601標記法,並使用UTC時間。格式為yyyy-MM-ddTHH:mm:ssZ。 |
| EndTime | String | 否 | 2019-11-30T05:40:00Z |
擷取資料結束時間點。日期格式按照ISO8601標記法,並使用UTC時間。格式為yyyy-MM-ddTHH:mm:ssZ。 結束時間需大於起始時間。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
|---|---|---|---|
| DataInterval | String | 86400 |
時間間隔,單位:秒。 |
| DomainName | String | example.com |
加速網域名稱。 |
| EndTime | String | 2019-11-30T05:40:00Z |
擷取資料結束時間點。 |
| RequestId | String | DE81639B-DAC1-4C76-AB72-F34B836837D5 |
請求ID。 |
| StartTime | String | 2019-11-29T05:33:00Z |
擷取資料起始時間點。 |
| Value | Array of ISPProportionData |
各電訊廠商訪問佔比資料列表。 |
|
| ISPProportionData | |||
| AvgObjectSize | String | 7081884.7 |
響應平均大小,單位:byte。 |
| AvgResponseRate | String | 88.92594866772144 |
平均響應速度,單位:byte/毫秒。 |
| AvgResponseTime | String | 79638.0 |
平均回應時間,單位:毫秒。 |
| Bps | String | 1311.4601296296296 |
頻寬。 |
| BytesProportion | String | 0.012220518530445479 |
總流量佔比。 |
| ISP | String | 阿里巴巴 |
電訊廠商資訊。 |
| IspEname | String | alibaba |
電訊廠商英文名稱。 |
| Proportion | String | 0.004509176173513099 |
佔比使用資料。 |
| Qps | String | 2.3148148148148147E-5 |
每秒查詢率。 |
| ReqErrRate | String | 0.0 |
請求錯誤率。 |
| TotalBytes | String | 7081884 |
總流量。 |
| TotalQuery | String | 1 |
總請求次數。 |
樣本
請求樣本
http://cdn.aliyuncs.com/?Action=DescribeDomainISPData &DomainName=example.com &StartTime=2015-12-05T00:00:00Z &EndTime=2019-11-30T05:40:00Z &<公用請求參數>
正常返回樣本
XML 格式
<DescribeDomainISPDataResponse> <Value> <ISPProportionData> <ByteHitRate>100.0</ByteHitRate> <TotalQuery>1</TotalQuery> <Bps>1311.4601296296296</Bps> <Proportion>0.004509176173513099</Proportion> <AvgResponseRate>88.92594866772144</AvgResponseRate> <IspEname>alibaba</IspEname> <AvgObjectSize>7081884.7</AvgObjectSize> <ISP>阿里巴巴</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>2.3148148148148147E-5</Qps> <AvgResponseTime>79638.0</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>7081884</TotalBytes> <BytesProportion>0.012220518530445479</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>100.0</ByteHitRate> <TotalQuery>3</TotalQuery> <Bps>444.455</Bps> <Proportion>0.013527528520539298</Proportion> <AvgResponseRate>154.3345765545624</AvgResponseRate> <IspEname>overseas</IspEname> <AvgObjectSize>800019.0</AvgObjectSize> <ISP>海外ISP</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>6.944444444444444E-5</Qps> <AvgResponseTime>5183.666666666667</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>2400057</TotalBytes> <BytesProportion>0.004141544558417533</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>100.0</ByteHitRate> <TotalQuery>82</TotalQuery> <Bps>45838.64816666667</Bps> <Proportion>0.3697524462280741</Proportion> <AvgResponseRate>1025.5028528460102</AvgResponseRate> <IspEname>drpeng</IspEname> <AvgObjectSize>3018642.684146342</AvgObjectSize> <ISP>鵬博士</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.0018981481481481482</Qps> <AvgResponseTime>2943.5731707317073</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>247528700</TotalBytes> <BytesProportion>0.42713616424581613</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>99.99999999999999</ByteHitRate> <TotalQuery>114</TotalQuery> <Bps>65933.51396296297</Bps> <Proportion>0.5140460837804933</Proportion> <AvgResponseRate>484.6396117340071</AvgResponseRate> <IspEname>cernet</IspEname> <AvgObjectSize>3123166.4508771934</AvgObjectSize> <ISP>教育網</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.002638888888888889</Qps> <AvgResponseTime>6444.30701754386</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>356040975</TotalBytes> <BytesProportion>0.6143852267848392</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>100.0</ByteHitRate> <TotalQuery>207</TotalQuery> <Bps>81128.73735185186</Bps> <Proportion>0.9333994679172115</Proportion> <AvgResponseRate>752.2096624205244</AvgResponseRate> <IspEname>tietong</IspEname> <AvgObjectSize>2116401.843961353</AvgObjectSize> <ISP>鐵通</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.004791666666666666</Qps> <AvgResponseTime>2813.5797101449275</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>438095181</TotalBytes> <BytesProportion>0.7559781771177001</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>100.00000000000001</ByteHitRate> <TotalQuery>256</TotalQuery> <Bps>129137.37100000001</Bps> <Proportion>1.1543491004193533</Proportion> <AvgResponseRate>321.5924922592767</AvgResponseRate> <IspEname>other</IspEname> <AvgObjectSize>2723991.4195312504</AvgObjectSize> <ISP>其他</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.005925925925925926</Qps> <AvgResponseTime>8470.3203125</AvgResponseTime> <ReqHitRate>100.0</ReqHitRate> <TotalBytes>697341803</TotalBytes> <BytesProportion>1.2033348171432345</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>99.14745652563326</ByteHitRate> <TotalQuery>2866</TotalQuery> <Bps>879955.1972037038</Bps> <Proportion>12.923298913288543</Proportion> <AvgResponseRate>1004.5513789924338</AvgResponseRate> <IspEname>mobile</IspEname> <AvgObjectSize>1657975.598360084</AvgObjectSize> <ISP>移動</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.06634259259259259</Qps> <AvgResponseTime>1650.463712491277</AvgResponseTime> <ReqHitRate>97.3831123517097</ReqHitRate> <TotalBytes>4751758064</TotalBytes> <BytesProportion>8.19964599032574</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>99.99981717005271</ByteHitRate> <TotalQuery>6534</TotalQuery> <Bps>3194660.60262963</Bps> <Proportion>29.46295711773459</Proportion> <AvgResponseRate>1171.525957981939</AvgResponseRate> <IspEname>unicom</IspEname> <AvgObjectSize>2640215.374074074</AvgObjectSize> <ISP>聯通</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.15125</Qps> <AvgResponseTime>2253.6550352004897</AvgResponseTime> <ReqHitRate>99.96939087848179</ReqHitRate> <TotalBytes>17251167254</TotalBytes> <BytesProportion>29.768658772680293</BytesProportion> </ISPProportionData> <ISPProportionData> <ByteHitRate>99.99968869093071</ByteHitRate> <TotalQuery>12114</TotalQuery> <Bps>6333214.260796296</Bps> <Proportion>54.62416016593768</Proportion> <AvgResponseRate>984.184264638081</AvgResponseRate> <IspEname>telecom</IspEname> <AvgObjectSize>2823126.71357933</AvgObjectSize> <ISP>電信</ISP> <ReqErrRate>0.0</ReqErrRate> <Qps>0.28041666666666665</Qps> <AvgResponseTime>2868.494056463596</AvgResponseTime> <ReqHitRate>99.97523526498266</ReqHitRate> <TotalBytes>34199357008</TotalBytes> <BytesProportion>59.01449878861353</BytesProportion> </ISPProportionData> </Value> <DataInterval>86400</DataInterval> <RequestId>DE81639B-DAC1-4C76-AB72-F34B836837D5</RequestId> <DomainName>example.com</DomainName> <EndTime>2019-11-29T05:33:00Z</EndTime> <StartTime>2019-11-29T05:33:00Z</StartTime> </DescribeDomainISPDataResponse>
JSON 格式
{ "Value": { "ISPProportionData": [{ "ByteHitRate": "100.0", "TotalQuery": "1", "Bps": "1311.4601296296296", "Proportion": "0.004509176173513099", "AvgResponseRate": "88.92594866772144", "IspEname": "alibaba", "AvgObjectSize": "7081884.7", "ISP": "阿里巴巴", "ReqErrRate": "0.0", "Qps": "2.3148148148148147E-5", "AvgResponseTime": "79638.0", "ReqHitRate": "100.0", "TotalBytes": "7081884", "BytesProportion": "0.012220518530445479" }, { "ByteHitRate": "100.0", "TotalQuery": "3", "Bps": "444.455", "Proportion": "0.013527528520539298", "AvgResponseRate": "154.3345765545624", "IspEname": "overseas", "AvgObjectSize": "800019.0", "ISP": "海外ISP", "ReqErrRate": "0.0", "Qps": "6.944444444444444E-5", "AvgResponseTime": "5183.666666666667", "ReqHitRate": "100.0", "TotalBytes": "2400057", "BytesProportion": "0.004141544558417533" }, { "ByteHitRate": "100.0", "TotalQuery": "82", "Bps": "45838.64816666667", "Proportion": "0.3697524462280741", "AvgResponseRate": "1025.5028528460102", "IspEname": "drpeng", "AvgObjectSize": "3018642.684146342", "ISP": "鵬博士", "ReqErrRate": "0.0", "Qps": "0.0018981481481481482", "AvgResponseTime": "2943.5731707317073", "ReqHitRate": "100.0", "TotalBytes": "247528700", "BytesProportion": "0.42713616424581613" }, { "ByteHitRate": "99.99999999999999", "TotalQuery": "114", "Bps": "65933.51396296297", "Proportion": "0.5140460837804933", "AvgResponseRate": "484.6396117340071", "IspEname": "cernet", "AvgObjectSize": "3123166.4508771934", "ISP": "教育網", "ReqErrRate": "0.0", "Qps": "0.002638888888888889", "AvgResponseTime": "6444.30701754386", "ReqHitRate": "100.0", "TotalBytes": "356040975", "BytesProportion": "0.6143852267848392" }, { "ByteHitRate": "100.0", "TotalQuery": "207", "Bps": "81128.73735185186", "Proportion": "0.9333994679172115", "AvgResponseRate": "752.2096624205244", "IspEname": "tietong", "AvgObjectSize": "2116401.843961353", "ISP": "鐵通", "ReqErrRate": "0.0", "Qps": "0.004791666666666666", "AvgResponseTime": "2813.5797101449275", "ReqHitRate": "100.0", "TotalBytes": "438095181", "BytesProportion": "0.7559781771177001" }, { "ByteHitRate": "100.00000000000001", "TotalQuery": "256", "Bps": "129137.37100000001", "Proportion": "1.1543491004193533", "AvgResponseRate": "321.5924922592767", "IspEname": "other", "AvgObjectSize": "2723991.4195312504", "ISP": "其他", "ReqErrRate": "0.0", "Qps": "0.005925925925925926", "AvgResponseTime": "8470.3203125", "ReqHitRate": "100.0", "TotalBytes": "697341803", "BytesProportion": "1.2033348171432345" }, { "ByteHitRate": "99.14745652563326", "TotalQuery": "2866", "Bps": "879955.1972037038", "Proportion": "12.923298913288543", "AvgResponseRate": "1004.5513789924338", "IspEname": "mobile", "AvgObjectSize": "1657975.598360084", "ISP": "移動", "ReqErrRate": "0.0", "Qps": "0.06634259259259259", "AvgResponseTime": "1650.463712491277", "ReqHitRate": "97.3831123517097", "TotalBytes": "4751758064", "BytesProportion": "8.19964599032574" }, { "ByteHitRate": "99.99981717005271", "TotalQuery": "6534", "Bps": "3194660.60262963", "Proportion": "29.46295711773459", "AvgResponseRate": "1171.525957981939", "IspEname": "unicom", "AvgObjectSize": "2640215.374074074", "ISP": "聯通", "ReqErrRate": "0.0", "Qps": "0.15125", "AvgResponseTime": "2253.6550352004897", "ReqHitRate": "99.96939087848179", "TotalBytes": "17251167254", "BytesProportion": "29.768658772680293" }, { "ByteHitRate": "99.99968869093071", "TotalQuery": "12114", "Bps": "6333214.260796296", "Proportion": "54.62416016593768", "AvgResponseRate": "984.184264638081", "IspEname": "telecom", "AvgObjectSize": "2823126.71357933", "ISP": "電信", "ReqErrRate": "0.0", "Qps": "0.28041666666666665", "AvgResponseTime": "2868.494056463596", "ReqHitRate": "99.97523526498266", "TotalBytes": "34199357008", "BytesProportion": "59.01449878861353" }] }, "DataInterval": "86400", "RequestId": "DE81639B-DAC1-4C76-AB72-F34B836837D5", "DomainName": "downtest.cdnpe.com", "EndTime": "2019-11-30T05:40:00Z", "StartTime": "2019-11-29T05:33:00Z" }
錯誤碼
| HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 開始時間設定錯誤,請檢查更新後重試。 |
| 404 | InvalidDomain.NotFound | The domain provided does not exist in our records. | 網域名稱不存在或不屬於目前使用者。請檢查您填寫的網域名稱書寫是否正確,或者網域名稱是否在當前帳號中,查看網域名稱是否到期。 |
訪問 錯誤中心查看更多錯誤碼。