調用DescribeUsageAreaDistributionStatData獲取用量統計的地域分布數據。

使用說明

本接口用于獲取用量統計的地域分布數據。使用該接口時，限制如下：

  • 支持查詢最近365天（不包含查詢當天）任意范圍的數據。
  • 如果查詢范圍小于24小時，則按小時統計查詢的數據；如果查詢范圍大于或等于24小時，則按天統計查詢的數據。

QPS限制

本接口的單用戶QPS限制為10次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見QPS限制。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數文檔。

請求語法

POST /api/usage/describeUsageAreaDistributionStatData HTTP/1.1

請求參數

名稱 類型 位置 是否必選 示例值 描述
StartDate String Query 是 1615824000

查詢的開始時間，使用UNIX時間戳表示，單位：秒。
EndDate String Query 是 1615910399

查詢的結束時間，使用UNIX時間戳表示，單位：秒。
ParentArea String Query 否 中國_浙江省

父級地區名稱，例如：杭州市的父級為浙江省，參數設為中國_浙江省。參數為空表示世界范圍（國家維度）的統計，例如：中國、英國。
AppId String Query 是 0rbd****

App ID，可通過控制臺創建和查詢。

返回數據

名稱 類型 示例值 描述
UsageAreaStatList Array of UsageAreaStatData

用量統計的地域分布數據列表。
Name String 中國_浙江省

地域名稱。
AudioCallDuration Integer 160

音頻通話時長，單位：分鐘。
VideoCallDuration Integer 17361

視頻通話時長，單位：分鐘。
TotalCallDuration Integer 17521

總通話時長，單位：分鐘。
RequestId String 4473A35B-18C1-4D91-A596-32F99C7D1C8B

請求ID。

示例

請求示例

POST /api/usage/describeUsageAreaDistributionStatData?StartDate=1615824000&EndDate=1615910399&ParentArea=中國_浙江省&AppId=0rbd**** HTTP/1.1
Host: vdc.cn-shenzhen.aliyuncs.com 
Date: GMT Date

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeUsageAreaDistributionStatDataResponse>
    <code>200</code>
    <data>
        <RequestId>4473A35B-18C1-4D91-A596-32F99C7D1C8B</RequestId>
        <UsageAreaStatList>
            <AudioCallDuration>160</AudioCallDuration>
            <TotalCallDuration>17521</TotalCallDuration>
            <VideoCallDuration>17361</VideoCallDuration>
            <Name>中國_浙江省</Name>
        </UsageAreaStatList>
        <UsageAreaStatList>
            <AudioCallDuration>22</AudioCallDuration>
            <TotalCallDuration>2538</TotalCallDuration>
            <VideoCallDuration>2516</VideoCallDuration>
            <Name>中國_浙江省</Name>
        </UsageAreaStatList>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>4473A35B-18C1-4D91-A596-32F99C7D1C8B</requestId>
    <successResponse>true</successResponse>
</DescribeUsageAreaDistributionStatDataResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "code" : "200",
  "data" : {
    "RequestId" : "4473A35B-18C1-4D91-A596-32F99C7D1C8B",
    "UsageAreaStatList" : [ {
      "AudioCallDuration" : 160,
      "TotalCallDuration" : 17521,
      "VideoCallDuration" : 17361,
      "Name" : "中國_浙江省"
    }, {
      "AudioCallDuration" : 22,
      "TotalCallDuration" : 2538,
      "VideoCallDuration" : 2516,
      "Name" : "中國_浙江省"
    } ]
  },
  "httpStatusCode" : "200",
  "requestId" : "4473A35B-18C1-4D91-A596-32F99C7D1C8B",
  "successResponse" : true
}