全部產品
Search

搜尋本產品

    Edge Security Acceleration：DescribeDcdnDomainIpaTrafficData - 擷取四層加速流量監控資料

    文件中心

    Edge Security Acceleration：DescribeDcdnDomainIpaTrafficData - 擷取四層加速流量監控資料

    更新時間：Sep 15, 2025

    調用DescribeDcdnDomainIpaTrafficData擷取加速網域名稱的四層加速網路流量監控資料，支援擷取最近90天的資料。

    介面說明

    說明

    • 不指定 StartTime 和 EndTime，預設返回過去 24 小時的資料；指定 StartTime 和 EndTime，返回指定起止時間的資料。

    • 該介面擷取資料的單位為：byte。

    • 單使用者調用頻率：100 次/秒。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dcdn:DescribeDcdnDomainIpaTrafficData

    get

    *IpaDomain

    acs:dcdn:*:{#accountId}:domain/{#domainName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DomainName

    string

    否

    加速網域名稱。

    多個網域名稱用英文逗號（,）分隔，預設查詢所有加速網域名稱。

    example.com
    StartTime

    string

    否

    擷取資料的起始時間點。

    日期格式按照 ISO8601 標記法，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

    2017-12-10T20:00:00Z
    EndTime

    string

    否

    擷取資料的結束時間點。

    日期格式按照 ISO8601 標記法，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

    說明

    結束時間需大於起始時間。

    2017-12-10T21:00:00Z
    TimeMerge

    string

    否

    是否自適應計算 interval 值，如果 timeMerge=1，會根據 StartTime 和 EndTime 計算出合適的 inteval 值，和 interval 參數任選。

    1
    Interval

    string

    否

    查詢資料的時間粒紋，單位為秒。

    根據您指定 StartTime 和 EndTime 兩者的時間跨度，該參數取值如下：

    • 3 天以內（不包含 3 天整）：支援 300、3600、 86400，如果不傳該參數，預設值為 300。

    • 3~31 天（不包含 31 天整）：支援 3600 和 86400，如果不傳該參數，預設值為 3600。

    • 31 天及以上：支援 86400，如果不傳該參數，預設值為 86400。

    300
    FixTimeGap

    string

    否

    是否補零。取值：

    • true：補零。

    • false：不補零。

    false
    IspNameEn

    string

    否

    電訊廠商英文名。

    您可以調用 DescribeDcdnRegionAndIsp 介面擷取，預設查詢所有電訊廠商。

    unicom
    LocationNameEn

    string

    否

    地區商英文名。

    您可以調用 DescribeDcdnRegionAndIsp 介面擷取，預設查詢所有地區。

    beijing

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    EndTime

    string

    結束時間。

    2017-12-10T21:00:00Z
    StartTime

    string

    開始時間。

    2017-12-10T20:00:00Z
    RequestId

    string

    請求 ID。

    B955107D-E658-4E77-B913-E0AC3D31693E
    DomainName

    string

    加速網域名稱資訊。

    example.com
    DataInterval

    string

    每條記錄的時間間隔，以秒為單位。

    300
    TrafficDataPerInterval

    object

    DataModule

    array<object>

    每個時間間隔的流量資料。

    object

    IpaTraffic

    number

    總流量。

    423304182
    TimeStamp

    string

    時間片起始時刻。

    2017-12-10T20:00:00Z

    樣本

    正常返回樣本

    JSON格式

    {
  "EndTime": "2017-12-10T21:00:00Z",
  "StartTime": "2017-12-10T20:00:00Z",
  "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
  "DomainName": "example.com",
  "DataInterval": "300",
  "TrafficDataPerInterval": {
    "DataModule": [
      {
        "IpaTraffic": 423304182,
        "TimeStamp": "2017-12-10T20:00:00Z"
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 MissingTimeParameter The StartTime and EndTime must be both specified. 請同時提供開始時間和結束時間。
    400 InvalidStartTime.Malformed The specified StartTime parameter is invalid. 請提供正確的開始時間格式。日期格式按照ISO8601標記法，並使用UTC時間，格式為：yyyy-MM-ddTHH:mm:ssZ。
    400 InvalidEndTime.Malformed The specified EndTime is invalid. 請提供正確的結束時間格式。日期格式按照ISO8601標記法，並使用UTC時間。 格式為：yyyy-MM-ddTHH:mm:ssZ。
    400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. 結束時間早於開始時間，請檢查。
    400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. 不支援該開始時間，請重新填寫。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。