全部產品
Search

搜尋本產品

    Smart Access Gateway：GetQosAttribute - 查詢QOS詳情資訊

    文件中心

    Smart Access Gateway：GetQosAttribute - 查詢QOS詳情資訊

    更新時間：Dec 21, 2025

    調用GetQosAttribute介面查詢QoS策略執行個體資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    smartag:GetQosAttribute

    get

    *Qos

    acs:smartag:{#regionId}:{#accountId}:qos/{#QosId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    QoS 策略執行個體所屬地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    cn-shanghai
    QosId

    string

    是

    QoS 策略執行個體 ID。

    qos-1iqifund3gcno5****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    QosPolicies

    array<object>

    QoS 策略執行個體的五元組規則資訊列表。

    object

    QoS 策略執行個體的五元組規則資訊。

    EndTime

    integer

    五元組規則失效時間。

    時間顯示為北京時間，格式為：UTC 時間+8 小時。

    2021-07-29T00:00:00+0800
    StartTime

    integer

    五元組規則開始生效時間。

    2021-06-21T00:00:00+0800
    DestCidr

    string

    目的網段。

    0.0.0.0/0
    DestPortRange

    string

    目的連接埠範圍。

    取值範圍：-1或 1~65535。

    目的連接埠範圍格式樣本：

    • 1/200，表示連接埠範圍 1 至 200。

    • 80/80，表示連接埠 80。

    • -1/-1，表示不限制連接埠。

    -1/-1
    IpProtocol

    string

    五元組規則應用的協議類型。

    ALL
    Priority

    integer

    五元組規則所屬的限速規則的優先順序。

    數值越小，優先順序越高。

    1
    QosPolicieDescription

    string

    五元組規則的描述資訊。

    test
    SourceCidr

    string

    源網段。

    0.0.0.0/0
    QosPolicieName

    string

    五元組規則名稱。

    test
    SourcePortRange

    string

    源連接埠範圍。

    取值範圍：-1或 1~65535。

    源連接埠範圍格式例如：

    • 1/200，表示連接埠範圍 1 至 200。

    • 80/80，表示連接埠 80。

    • -1/-1，表示不限制連接埠。

    -1/-1
    QosCars

    array<object>

    配置異常的 QoS 策略限速規則資訊。

    object

    QoS 策略執行個體的限速規則資訊列表。

    MaxBandwidthAbs

    integer

    最大頻寬。單位：Mbps。

    2
    QosCarName

    string

    限速規則的名稱。

    test
    PercentSourceType

    string

    按百分比限速時的頻寬類型：

    • CcnBandwidth：雲串連網頻寬。

    • InternetUpBandwidth：公網上行頻寬。

    InternetUpBandwidth
    MinBandwidthAbs

    integer

    最小頻寬。單位：Mbps。

    1
    MaxBandwidthPercent

    integer

    最大頻寬百分比。

    20
    QosCarDescription

    string

    限速規則的描述資訊。

    test
    LimitType

    string

    限速類型：

    • Absolute：按頻寬值。

    • Percent：按百分比。

    Absolute
    Priority

    integer

    限速規則的優先順序。

    優先順序支援設定 1~3 級，數值越小，優先順序越高。

    1
    MinBandwidthPercent

    integer

    最小頻寬百分比。

    10
    QosCarId

    string

    限速規則 ID。

    qoscar-xir1apa8ayjp56ei****
    RequestId

    string

    請求 ID。

    91058E01-1806-45D5-B305-19E4D0A5CE04
    ErrorConfigSmartAGCount

    integer

    配置異常的Smart Access Gateway執行個體個數。

    1
    QosName

    string

    QoS 策略執行個體的名稱。

    test
    QosDescription

    string

    QoS 策略執行個體的描述資訊。

    test

    樣本

    正常返回樣本

    JSON格式

    {
  "QosPolicies": [
    {
      "EndTime": 0,
      "StartTime": 0,
      "DestCidr": "0.0.0.0/0",
      "DestPortRange": "-1/-1",
      "IpProtocol": "ALL",
      "Priority": 1,
      "QosPolicieDescription": "test",
      "SourceCidr": "0.0.0.0/0",
      "QosPolicieName": "test",
      "SourcePortRange": "-1/-1"
    }
  ],
  "QosCars": [
    {
      "MaxBandwidthAbs": 2,
      "QosCarName": "test",
      "PercentSourceType": "InternetUpBandwidth",
      "MinBandwidthAbs": 1,
      "MaxBandwidthPercent": 20,
      "QosCarDescription": "test",
      "LimitType": "Absolute",
      "Priority": 1,
      "MinBandwidthPercent": 10,
      "QosCarId": "qoscar-xir1apa8ayjp56ei****"
    }
  ],
  "RequestId": "91058E01-1806-45D5-B305-19E4D0A5CE04",
  "ErrorConfigSmartAGCount": 1,
  "QosName": "test",
  "QosDescription": "test"
}

    錯誤碼

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

    變更歷史

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