すべてのプロダクト
Search
ドキュメントセンター

Express Connect:DescribeExpressConnectTrafficQos

最終更新日:Apr 27, 2026

Express Connect のサービス品質 (QoS) ポリシーをクエリします。応答はページ単位で表示できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

QoS ポリシーが作成されたリージョンの ID です。

最新のリージョン一覧を取得するには、DescribeRegions 操作を呼び出してください。

cn-shanghai

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。クライアントトークンには ASCII 文字のみを使用できます。

説明

このパラメーターを指定しない場合、システムは自動的に リクエスト IDクライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる場合があります。

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

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。クライアントトークンには ASCII 文字のみを使用できます。

説明

このパラメーターを指定しない場合、システムは自動的に リクエスト IDクライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる場合があります。

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

QosIdList

array

任意

QoS ポリシーの ID です。

string

任意

QoS ポリシーの ID です。

qos-2giu0a6vd5x0mv****

QosNameList

array

任意

QoS ポリシーの名前です。

string

任意

QoS ポリシーの名前です。

qos-test

NextToken

string

任意

次のリクエストで新しい結果ページを取得するために使用されるページネーショントークンです。

  • NetToken の値が返されない場合は、このパラメーターを指定する必要はありません。

  • NextToken の値が返される場合は、直前のクエリから取得したトークンを NextToken の値として指定する必要があります。

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

任意

返されるエントリの最大数です。有効値:1100。デフォルト値:10

20

ResourceGroupId

string

任意

リソースグループ ID です。

rg-acfmxazfdgdg****

Tags

array<object>

任意

リソースのタグです。

object

任意

リソースのタグです。

Key

string

任意

タグキーです。少なくとも 1 つのタグキーを入力する必要があります。最大 20 個のタグキーを指定できます。タグキーは空文字にできません。

タグキーの長さは最大 128 文字です。aliyun または acs: で始まることはできません。また、http:// または https:// を含んではいけません。

FinanceDept

Value

string

任意

リソースのタグ値です。最大 20 個のタグ値を指定できます。タグ値は空文字にできます。

タグ値の長さは最大 128 文字です。http:// または https:// を含んではいけません。また、aliyun または acs: で始まってはいけません。

FinanceJoshua

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID です。

4CF20CC7-D1FC-425B-A15B-DF7C8E2131A7

NextToken

string

ページネーショントークンです。次のリクエストで新しい結果ページを取得するために使用できます。

  • NextToken が空の場合、次のページは存在しません。

  • NextToken の値が返される場合、その値を次のリクエストで使用して新しい結果ページを取得できます。

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResults

integer

1 ページあたりのエントリ数です。有効値: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 ポリシーの名前です。

名前の長さは最大 128 文字です。http:// または https:// で始まってはいけません。

qos-test

QosDescription

string

QoS ポリシーの説明です。

説明の長さは最大 256 文字です。http:// または https:// で始まってはいけません。

qos-test

Status

string

QoS ポリシーの状態です。有効値:

  • Normal:QoS ポリシーは利用可能です。

  • Configuring:QoS ポリシーは構成中です。

説明

QoS ポリシーが Configuring 状態の場合、QoS ポリシー、QoS キュー、または QoS ルールの作成、更新、削除に関するほとんどの操作を実行できません。

列挙値:

  • Configuring :

    Configuring

  • Normal :

    Normal

Normal

Progressing

integer

QoS ポリシーの構成進捗です。有効値:0100

100

AssociatedInstanceList

array<object>

QoS ポリシーが関連付けられているインスタンスに関する情報です。

object

InstanceId

string

QoS ポリシーが関連付けられているインスタンスの ID です。

pc-bp159zj8zujwy3p07****

InstanceType

string

QoS ポリシーが関連付けられているインスタンスのタイプです。返される値は PHYSICALCONNECTION のみです。

列挙値:

  • PHYSICALCONNECTION :

    PHYSICALCONNECTION

PHYSICALCONNECTION

InstanceStatus

string

QoS ポリシーが関連付けられているインスタンスの状態です。有効値:

  • Normal:インスタンスは利用可能です。

  • Configuring:インスタンスは構成中です。

  • Deleting:インスタンスは削除中です。

列挙値:

  • Configuring :

    Configuring

  • Normal :

    Normal

  • Deleting :

    Deleting

Normal

InstanceProgressing

integer

QoS ポリシーが関連付けられているインスタンスの構成進捗です。有効値:0100

100

QueueList

array<object>

QoS キューに関する情報です。

object

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 キューに割り当てられた帯域幅の割合です。

  • QueueType が Medium に設定されている場合、このパラメーターは必須です。有効値:1100

  • QueueType が Default に設定されている場合、- が返されます。

100

QueueName

string

QoS キューの名前です。

名前の長さは最大 128 文字です。http:// または https:// で始まってはいけません。

qos-queue-test

QueueDescription

string

QoS キューの説明です。

説明の長さは最大 256 文字です。http:// または https:// で始まってはいけません。

qos-queue-test

Status

string

QoS キューの状態です。有効値:

  • Normal:QoS キューは利用可能です。

  • Configuring:QoS キューは構成中です。

  • Deleting:QoS キューは削除中です。

Normal

ResourceGroupId

string

リソースグループの ID です。

rg-acfmz7vtyl4f***

Tags

array<object>

タグリストです。

object

タグリストです。

Key

string

タグキーです。

FinanceDept

Value

string

タグ値です。

FinanceJoshua

成功レスポンス

JSONJSON

{
  "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 ステータスコード

エラーコード

エラーメッセージ

説明

400 IllegalParam.%s The param of %s is illegal.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。