全部產品
Search

搜尋本產品

    ENS：DescribeInstanceBandwidthDetail - 分頁查詢流量頻寬詳細資料

    文件中心

    ENS：DescribeInstanceBandwidthDetail - 分頁查詢流量頻寬詳細資料

    更新時間：Mar 20, 2026

    查詢執行個體5分鐘粒度頻寬明細。

    介面說明

    • 請求參數的作用類似於一個過濾器，過濾器為邏輯與（AND）關係。如果某一參數為空白，則過濾器不起作用。但是參數 InstanceIds 如果是一個空 JSON 數組，則視為該過濾器有效，且返回空。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeInstanceBandwidthDetail

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    StartTime

    string

    是

    開始時間，格式: yyyy-MM-dd HH:mm:ss。

    2024-01-11 00:00:00
    EndTime

    string

    是

    截止時間，與開始時間差最大為 86400 秒。開始和截止為左閉右開查詢。格式: yyyy-MM-dd HH:mm:ss。

    2024-01-11 30:00:00
    ServiceType

    string

    否

    服務類型，如 vm,eip,esk,meta 等。

    vm
    InstanceType

    string

    否

    執行個體類型，無特殊查詢可不填寫。如 vm,eip, single_tenant,nc 等。

    vm
    EnsRegionId

    string

    否

    ENS 節點 ID。

    cn-beijing-cmcc
    InstanceId

    string

    否

    執行個體 ID。

    i-6ecpqvkicnchxccozrpxxxx
    PageNumber

    integer

    否

    查詢分頁，預設值為: 1。

    1
    PageSize

    integer

    否

    分頁大小，預設單次 200 條。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    Id of the request

    C0003E8B-B930-4F59-ADC0-0E209A9012A8
    Bandwidths

    array<object>

    公網頻寬上限資訊組成的集合。

    object

    公網頻寬上限資訊組成的集合。

    InstanceId

    string

    執行個體 ID。

    i-6ecpqvkicnchxccozrpxxxx
    ServiceType

    string

    服務類型，如 vm,eip,esk,meta 等。

    vm
    InstanceType

    string

    執行個體類型，如 vm,eip, single_tenant,nc 等。

    vm
    AliUid

    integer

    使用者識別碼。

    1972653484384661
    EnsRegionId

    string

    節點 ID。

    cn-yichang-2
    TxBw

    integer

    出向頻寬, 單位: bps。

    25415638
    RxBw

    integer

    入向頻寬, 單位: bps。

    43795230
    Ip

    string

    執行個體 IP。

    203.107.***
    Isp

    string

    ip 所屬電訊廠商。

    cmcc
    FlowType

    integer

    頻寬類型，1: 公網，2: 內網。

    1
    BizTime

    string

    頻寬業務時間，頻寬計算粒度為 5 分鐘。

    2024-01-11 00:00:00
    PageNumber

    integer

    當前頁數。

    1
    PageSize

    integer

    分頁大小。

    10
    TotalCount

    integer

    總記錄數。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8",
  "Bandwidths": [
    {
      "InstanceId": "i-6ecpqvkicnchxccozrpxxxx",
      "ServiceType": "vm",
      "InstanceType": "vm",
      "AliUid": 1972653484384661,
      "EnsRegionId": "cn-yichang-2",
      "TxBw": 25415638,
      "RxBw": 43795230,
      "Ip": "203.107.***",
      "Isp": "cmcc",
      "FlowType": 1,
      "BizTime": "2024-01-11 00:00:00"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ParamNotEnough 參數不足
    400 ParamScopeError 參數值錯誤
    400 ParamTypeError 參數類型錯誤
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    變更歷史

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