すべてのプロダクト
Search

このプロダクト

    Cloud Enterprise Network:CreateCenInterRegionTrafficQosPolicy

    ドキュメントセンター

    Cloud Enterprise Network:CreateCenInterRegionTrafficQosPolicy

    最終更新日:Feb 09, 2026

    Enterprise Edition トランジットルーター上のリージョン間接続に対して、サービス品質（QoS）ポリシーを作成します。

    操作説明

    • QoS ポリシーは、Enterprise Edition トランジットルーター上で作成されたリージョン間接続のみでサポートされます。

    • トラフィックスケジューリングは、Enterprise Edition トランジットルーターのアウトバウンドトラフィックにのみ適用されます。

      たとえば、中国 (杭州) リージョンと中国 (青島) リージョンの間にリージョン間接続を作成し、中国 (杭州) リージョンのトランジットルーターに対して QoS ポリシーを作成した場合、この QoS ポリシーは、中国 (杭州) リージョンから中国 (青島) リージョンへのネットワークトラフィックの帯域幅を保証します。ただし、中国 (青島) リージョンから中国 (杭州) リージョンへのネットワークトラフィックには QoS ポリシーは適用されません。

    • CreateCenInterRegionTrafficQosPolicy は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、タスクをバックグラウンドで実行します。タスクのステータスを確認するには、ListCenInterRegionTrafficQosPolicies 操作を呼び出してください。

      • QoS ポリシーのステータスが Creating の場合、QoS ポリシーは作成中です。この状態では、QoS ポリシーをクエリできますが、その他の操作は実行できません。

      • QoS ポリシーのステータスが Active の場合、QoS ポリシーの作成が完了しています。

    前提条件

    CreateCenInterRegionTrafficQosPolicy 操作を呼び出す前に、以下の要件を満たしていることを確認してください。

    • リージョン間接続が作成済みである必要があります。詳細については、「CreateTransitRouterPeerAttachment」をご参照ください。

    • トラフィックマーク付けポリシーが作成済みである必要があります。詳細については、「CreateTrafficMarkingPolicy」をご参照ください。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cen:CreateCenInterRegionTrafficQosPolicy

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClientToken

    string

    任意

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

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

    123e4567-e89b-12d3-a456-426655****
    DryRun

    boolean

    任意

    API リクエストを事前チェックのみ実行するかどうかを指定します。有効な値は以下のとおりです。

    • true：リクエストを事前チェックしますが、QoS ポリシーは作成しません。システムは必須パラメーター、リクエストフォーマット、およびサービス制限をチェックします。チェックに失敗した場合はエラーメッセージが返され、チェックに合格した場合は DryRunOperation エラーコードが返されます。

    • false：API リクエストを送信します。事前チェックに合格した場合、QoS ポリシーが作成されます。これはデフォルト値です。

    false
    TransitRouterId

    string

    必須

    トランジットルーターの ID です。

    tr-8vbuqeo5h5pu3m01d****
    TransitRouterAttachmentId

    string

    必須

    リージョン間接続の ID です。

    tr-attach-r6g0m3epjehw57****
    TrafficQosPolicyName

    string

    任意

    QoS ポリシーの名前です。

    名前は空でも構いませんが、長さは 1～128 文字で、http:// または https:// で始めてはいけません。

    nametest
    TrafficQosPolicyDescription

    string

    任意

    QoS ポリシーの説明です。

    このパラメーターは任意です。説明を入力する場合は、長さが 1～256 文字で、http:// または https:// で始めてはいけません。

    desctest
    BandwidthGuaranteeMode

    string

    任意

    保証帯域幅の割り当てモードです。絶対帯域幅値または帯域幅のパーセント値を指定できます。有効な値は以下のとおりです。

    • byBandwidth：QoS キューに対して絶対帯域幅値を割り当てます。

    • byBandwidthPercent（デフォルト）：QoS キューに対して帯域幅のパーセント値を割り当てます。

    byBandwidthPercent
    TrafficQosQueues

    array<object>

    任意

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

    この操作を呼び出して QoS ポリシーに追加できる QoS キューは最大 3 個です。それ以上の QoS キューを追加するには、CreateCenInterRegionTrafficQosQueue 操作を呼び出してください。

    object

    任意

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

    QosQueueName

    string

    任意

    現在のキューの名前です。

    各 QoS ポリシーでは最大 3 個のキューをサポートします。各キューに名前を指定できます。

    名前は空でも構いませんが、長さは 1～128 文字で、http:// または https:// で始めてはいけません。

    nametest
    RemainBandwidthPercent

    string

    任意

    このキューが使用できるリージョン間帯域幅のパーセント値です。

    各 QoS ポリシーでは最大 10 個のキューをサポートします。各キューに対して有効なパーセント値を指定できます。

    たとえば、値 1 は、このキューがリージョン間帯域幅の 1% を消費できることを意味します。

    説明

    QoS ポリシー内のすべてのキューのパーセント値の合計は、100% を超えてはいけません。

    1
    Bandwidth

    string

    任意

    QoS キューが消費できる絶対帯域幅です。単位：Mbit/s。

    各 QoS ポリシーでは最大 10 個のキューをサポートします。各キューに対して有効な帯域幅値を指定できます。

    たとえば、値 1 は、このキューがリージョン間帯域幅の 1 Mbit/s を消費できることを意味します。

    説明

    QoS ポリシー内のすべてのキューの絶対帯域幅値の合計は、リージョン間接続の総帯域幅を超えてはいけません。

    1
    Dscps

    array

    任意

    現在のキューに一致する Differentiated Services Code Point（DSCP）値です。

    各 QoS ポリシーでは最大 3 個のキューをサポートします。各キューに対して最大 60 個の DSCP 値を指定できます。複数の DSCP 値はカンマ（,）で区切ります。

    integer

    任意

    現在のキューに一致する Differentiated Services Code Point（DSCP）値です。

    各 QoS ポリシーでは最大 3 個のキューをサポートします。各キューに対して最大 60 個の DSCP 値を指定できます。複数の DSCP 値はカンマ（,）で区切ります。

    5
    QosQueueDescription

    string

    任意

    現在のキューの説明です。

    各 QoS ポリシーでは最大 10 個のキューをサポートします。各キューに対して説明を指定できます。

    このパラメーターは任意です。説明を入力する場合は、長さが 1～256 文字で、http:// または https:// で始めてはいけません。

    desctest

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答です。

    TrafficQosPolicyId

    string

    QoS ポリシーの ID です。

    qos-eczzew0v1kzrb5****
    RequestId

    string

    リクエストの ID です。

    6DF9A765-BCD2-5C7E-8C32-C35C8A361A39

    例

    成功レスポンス

    JSONJSON

    {
  "TrafficQosPolicyId": "qos-eczzew0v1kzrb5****",
  "RequestId": "6DF9A765-BCD2-5C7E-8C32-C35C8A361A39"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 AssociationExist.TrafficQos The traffic qos with the specified attachment already exists.
    400 InvalidTransitRouterId.NotFound The specified TransitRouterId is not found.
    400 IllegalParam.TransitRouterAttachmentId TransitRouterAttachmentId is illegal.
    400 InvalidParamSize.TrafficQosQueues The queue size included in the traffic QoS policy exceeds the limit.
    400 IllegalParam.BandwidthGuaranteeModeMismatch The BandwidthGuaranteeMode does not match the Bandwidth or RemainBandwidthPercent.
    400 IllegalParam.AttachmentBandwidthExceed The entered bandwidth causes the total QoS guaranteed bandwidth to exceed the cross-region bandwidth allocation value.
    400 IllegalParam.BandwidthGuaranteeMode The input bandwidth guarantee type is not valid.
    400 MissingParam.RemainBandwidthPercent RemainBandwidthPercent is missing.
    400 MissingParam.Bandwidth The parameter Bandwidth is mandatory.
    400 IllegalParam.RemainBandwidthPercent The specified RemainBandwidthPercent is invalid.
    400 IllegalParam.Bandwidth Bandwidth is illegal
    400 IllegalParam.BandwidthPackageStatus The status of the bandwidth package is incorrect.
    400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect.
    400 IncorrectStatus.TransitRouterAttachment TransitRouterAttachmentId status is invalid.
    400 InvalidParameter Invalid parameter.
    400 Unauthorized The AccessKeyId is unauthorized.
    400 MissingParam.TransitRouterId The parameter TransitrouterId is mandatory.
    400 MissingParam.TransitRouterAttachmentId The parameter TransitRouterAttachmentId is Missing.
    400 Forbidden.CDTServiceExpired The CDT service is out of service.
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation.
    400 OperationUnsupported.QosPolicyForLowLatencyLinkType QoS Policy is not supported for Low Latency LinkType.

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

    変更履歴

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