全部產品
Search

搜尋本產品

    ENS：DescribeEpnBandWidthData - 查詢邊邊網路頻寬用量

    文件中心

    ENS：DescribeEpnBandWidthData - 查詢邊邊網路頻寬用量

    更新時間：Mar 20, 2026

    調用DescribeEpnBandWidthData查詢邊邊網路頻寬用量。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeEpnBandWidthData

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    EnsRegionId

    string

    否

    ENS 節點 ID。

    cn-beijing-cmcc
    InstanceId

    string

    否

    執行個體 ID。

    i-5sg1owx0g4ojy66ab2tez77r2
    StartTime

    string

    是

    擷取資料的起始時間點。

    • 按照 ISO8601 標準表示，並需要使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

    • 如果秒不是 00，則自動取為下一分鐘開始時。

    2021-12-15T16:00:00Z
    EndTime

    string

    是

    擷取資料的結束時間點。

    • 按照 ISO8601 標準表示，並需要使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

    • 如果秒不是 00，則自動取為下一分鐘開始時。

    2021-12-16T16:00:00Z
    Period

    string

    是

    擷取監控資料的精度，取值：300（預設值）、1200、3600、14400，單位：秒。

    300
    Isp

    string

    否

    電訊廠商，取值如下所示：

    • cmcc：移動。

    • telecom：電信。

    • unicom：聯通。

    • multiCarrier：多線。

    cmcc
    NetworkingModel

    string

    否

    組網模式。取值：

    • SpeedUp：智能加速（外網）。

    • Connection：內網聯通（內網模式）。

    • SpeedUpAndConnection：智能加速及內網聯通（內網模式）。

    SpeedUp
    EPNInstanceId

    string

    否

    邊邊網路執行個體 ID。

    epn-20200825134537VyK81T

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    MonitorData

    object

    執行個體的監控資料集合。

    BandWidthMonitorData

    array<object>

    頻寬監控資料。

    object

    頻寬監控資料。

    DownBandWidth

    integer

    下行頻寬，單位：bit/s。

    0
    InternetRX

    integer

    執行個體接收的公網資料流量，單位：bits。

    0
    InternetTX

    integer

    執行個體發送的公網資料流量，單位：bits。

    0
    TimeStamp

    string

    查詢監控資訊的時間戳記，UTC 時間，格式為 yyyy-MM-DDThh:mm:ssZ。

    2019-10-12T05:45:00Z
    UpBandWidth

    integer

    上行頻寬，單位：bit/s。

    0
    MaxDownBandWidth

    integer

    查詢時間段內最大下行頻寬，單位：bit/s。

    16817468
    MaxUpBandWidth

    integer

    查詢時間範圍內最大上行頻寬，單位：bit/s。

    231008
    RequestId

    string

    請求 ID。

    1D289DAA-F6DA-5FC4-AE47-F5C8B6277BFC

    樣本

    正常返回樣本

    JSON格式

    {
  "MonitorData": {
    "BandWidthMonitorData": [
      {
        "DownBandWidth": 0,
        "InternetRX": 0,
        "InternetTX": 0,
        "TimeStamp": "2019-10-12T05:45:00Z",
        "UpBandWidth": 0
      }
    ],
    "MaxDownBandWidth": 16817468,
    "MaxUpBandWidth": 231008
  },
  "RequestId": "1D289DAA-F6DA-5FC4-AE47-F5C8B6277BFC"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 MissingParameter The input parameters that is mandatory for processing this request is not supplied.
    400 USERNOTFOUND The user is not in ens-controller. 目前使用者未註冊邊緣節點服務或暫未通過使用者審核。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    變更歷史

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