全部產品
Search
文件中心

Express Connect:DescribeExpressConnectTrafficQos - 查詢Express ConnectQoS策略

更新時間:Apr 27, 2026

調用DescribeExpressConnectTrafficQos介面查詢Express ConnectQoS策略,支援分頁參數。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

QoS 策略所在的地區 ID。

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

cn-shanghai

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

02fb3da4-130e-11e9-8e44-0016e04115b

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

02fb3da4-130e-11e9-8e44-0016e04115b

QosIdList

array

QoS 策略 ID 集合。

string

QoS 策略 ID。

qos-2giu0a6vd5x0mv****

QosNameList

array

QoS 策略名稱稱集合。

string

QoS 策略名稱稱。

qos-test

NextToken

string

是否擁有下一次查詢的令牌(Token)。取值:

  • 第一次查詢和沒有下一次查詢時,均無需填寫。

  • 如果有下一次查詢,取值為上一次 API 呼叫返回的 NextToken 值。

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

分批次查詢時每次顯示的條目數。取值範圍:1~100,預設值為 20

20

ResourceGroupId

string

資源群組 ID。

rg-acfmxazfdgdg****

Tags

array<object>

資源的標籤。

object

標籤。

Key

string

資源的標籤鍵。至少輸入 1 個標籤鍵,最多支援輸入 20 個標籤鍵。如需傳入該值,不能輸入Null 字元串。

一個標籤鍵最多支援 128 個字元,不能以 aliyun 和 acs:開頭,不能包含 http://或者 https://。

FinanceDept

Value

string

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值,可以輸入Null 字元串。

最多支援 128 個字元,不能以 aliyun 和 acs:開頭,不能包含 http://或者 https://。

FinanceJoshua

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

NextToken

string

是否擁有下一次查詢的令牌(Token)。取值:

  • 第一次查詢和沒有下一次查詢時,均無需填寫。

  • 如果有下一次查詢,取值為上一次 API 呼叫返回的 NextToken 值。

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

分批次查詢時每次顯示的條目數。取值範圍:1~100,預設值為 20

20

TotalCount

integer

返回結果總數。

10

Count

string

列表當前條目數。

1

QosList

array<object>

QoS 策略資訊列表。

array<object>

QoS 策略資訊。

QosId

string

QoS 策略 ID。

qos-pksbqfmotl5hzq****

QosName

string

QoS 策略的名稱。

長度為 0128 個字元,不能以http://https://開頭。

qos-test

QosDescription

string

QoS 策略的描述資訊。

長度為 0256 個字元,不能以http://https://開頭。

qos-test

Status

string

QoS 策略的狀態。取值:

  • Normal:可用。

  • Configuring:配置中。

說明

處於配置中狀態的 QoS 將會限制絕大部分的 QoS 策略、QoS 隊列,QoS 規則的建立、更新和刪除操作。

枚舉值:

  • Configuring :

    Configuring

  • Normal :

    Normal

Normal

Progressing

integer

QoS 策略整體配置進度,取值範圍為:0~100

100

AssociatedInstanceList

array<object>

關聯執行個體列表。

object

關聯執行個體資訊。

InstanceId

string

關聯執行個體的 ID。

pc-bp159zj8zujwy3p07****

InstanceType

string

關聯執行個體的類型。取值:PHYSICALCONNECTION 物理專線。

枚舉值:

  • PHYSICALCONNECTION :

    PHYSICALCONNECTION

PHYSICALCONNECTION

InstanceStatus

string

關聯執行個體的狀態。取值:

  • Normal:可用。

  • Configuring:配置中。

  • Deleting:刪除中。

枚舉值:

  • Configuring :

    Configuring

  • Normal :

    Normal

  • Deleting :

    Deleting

Normal

InstanceProgressing

integer

關聯執行個體的配置進度,取值範圍為:0~100

100

QueueList

array<object>

QoS 隊列列表。

object

QoS 隊列資訊。

QosId

string

QoS 策略 ID。

qos-pksbqfmotl5hzq****

QueueId

string

QoS 隊列 ID。

qos-queue-9nyx2u7n71s2rc****

QueueType

string

QoS 隊列類型,取值:

  • High:高優先順序隊列。

  • Medium:普通優先順序隊列。

  • Default:預設優先順序隊列。

說明

預設優先順序隊列無法建立。

枚舉值:

  • High :

    High

  • Medium :

    Medium

  • Default :

    Default

High

BandwidthPercent

string

QoS 隊列頻寬百分比。

  • 當 QoS 隊列類型為 Medium 的時候,此欄位必須輸入,取值範圍為:1~100

  • 當 QoS 隊列類型為 Default 的時候,此欄位為"-"。

100

QueueName

string

QoS 隊列的名稱。

長度為 0128 個字元,不能以http://https://開頭。

qos-queue-test

QueueDescription

string

QoS 隊列的描述資訊。

長度為 0256 個字元,不能以http://https://開頭。

qos-queue-test

Status

string

QoS 隊列的狀態。取值:

  • Normal:可用。

  • Configuring:配置中。

  • Deleting:刪除中。

Normal

ResourceGroupId

string

資源群組 ID。

rg-acfmz7vtyl4f***

Tags

array<object>

資源的標籤。

object

標籤。

Key

string

資源的標籤鍵。

FinanceDept

Value

string

資源的標籤值。

FinanceJoshua

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7",
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "MaxResults": 20,
  "TotalCount": 10,
  "Count": "1",
  "QosList": [
    {
      "QosId": "qos-pksbqfmotl5hzq****",
      "QosName": "qos-test",
      "QosDescription": "qos-test",
      "Status": "Normal",
      "Progressing": 100,
      "AssociatedInstanceList": [
        {
          "InstanceId": "pc-bp159zj8zujwy3p07****",
          "InstanceType": "PHYSICALCONNECTION",
          "InstanceStatus": "Normal",
          "InstanceProgressing": 100
        }
      ],
      "QueueList": [
        {
          "QosId": "qos-pksbqfmotl5hzq****",
          "QueueId": "qos-queue-9nyx2u7n71s2rc****",
          "QueueType": "High",
          "BandwidthPercent": "100",
          "QueueName": "qos-queue-test",
          "QueueDescription": "qos-queue-test",
          "Status": "Normal"
        }
      ],
      "ResourceGroupId": "rg-acfmz7vtyl4f***",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ]
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 IllegalParam.%s The param of %s is illegal. 指定的參數非法

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

變更歷史

更多資訊,參考變更詳情