Enterprise Edition トランジットルーターのリージョン間トラフィックスケジューリングポリシーを作成し、リージョン間の制御ネットワークトラフィックを最適化およびコントロールします。
操作説明
-
Enterprise Edition トランジットルーターのリージョン間接続のみが、リージョン間トラフィックスケジューリングポリシーの作成をサポートしています。
-
トラフィックスケジューリング特徴は、Enterprise Edition トランジットルーターのアウトバウンド方向でのみ効果が現れます。
たとえば、中国（杭州）リージョンと中国（青島）リージョン間にリージョン間接続を作成し、中国（杭州）リージョンのトランジットルーターでトラフィックスケジューリング特徴を設定した場合、トラフィックスケジューリング特徴は、中国（杭州）リージョンから中国（青島）リージョンへのトラフィックフロー時に各種サービスの帯域幅を保証できます。ただし、中国（青島）リージョンから中国（杭州）リージョンへのトラフィックフロー時は、トラフィックスケジューリング特徴によるサービス帯域幅の保証は行われません。
-
CreateCenInterRegionTrafficQosPolicy は非同期操作です。リクエスト送信後、システムはトラフィックスケジューリングポリシー ID を返しますが、ポリシーはまだ作成されていません。作成タスクはバックグラウンドで継続して実行されます。ListCenInterRegionTrafficQosPolicies を呼び出して、トラフィックスケジューリングポリシーのステータスをクエリできます。
トラフィックスケジューリングポリシーが Creating 状態の場合、ポリシーは作成中です。この状態では、ポリシーのクエリのみが可能で、その他の操作は実行できません。
トラフィックスケジューリングポリシーが Active 状態の場合、ポリシーは作成済みです。
開始する前に
CreateCenInterRegionTrafficQosPolicy を呼び出す前に、以下の条件が満たされていることを確認してください。
リージョン間接続が作成されていること。詳細については、「 CreateTransitRouterPeerAttachment 」を参照してください。
トラフィックマーキングポリシーが作成されていること。詳細については、「 CreateTrafficMarkingPolicy 」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:CreateCenInterRegionTrafficQosPolicy |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字以下である必要があります。 |
123e4567-e89b-12d3-a456-426655**** |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値:
|
false |
| TransitRouterId |
string |
必須 |
トランジットルーターインスタンスの ID。 |
tr-8vbuqeo5h5pu3m01d**** |
| TransitRouterAttachmentId |
string |
必須 |
リージョン間接続の ID。 |
tr-attach-r6g0m3epjehw57**** |
| TrafficQosPolicyName |
string |
任意 |
トラフィックスケジューリングポリシーの名前。 名前は空、または 1～128 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
nametest |
| TrafficQosPolicyDescription |
string |
任意 |
トラフィックスケジューリングポリシーの説明。 説明は空、または 1～256 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
desctest |
| BandwidthGuaranteeMode |
string |
任意 |
帯域幅保証モード。絶対帯域幅値または帯域幅パーセンテージに基づいて QoS キューを設定できます。有効な値:
|
byBandwidthPercent |
| TrafficQosQueues |
array<object> |
任意 |
トラフィックスケジューリングポリシーのキュー情報。 最大 3 つのキューを作成できます。さらにキューを作成するには、CreateCenInterRegionTrafficQosQueue を呼び出してください。 |
|
|
object |
任意 |
キュー情報。 |
||
| QosQueueName |
string |
任意 |
キューの名前。 トラフィックスケジューリングポリシーは最大 3 つのキューをサポートしており、各キューに名前を割り当てることができます。 名前は空、または 1～128 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
nametest |
| RemainBandwidthPercent |
string |
任意 |
キューが使用できるリージョン間帯域幅のパーセンテージ。 トラフィックスケジューリングポリシーは最大 10 のキューをサポートしており、各キューにリージョン間帯域幅のパーセンテージを割り当てることができます。 たとえば、1 と入力した場合、そのキューに一致するトラフィックはリージョン間帯域幅の最大 1% を使用できます。 説明
トラフィックスケジューリングポリシー内のすべてのキューの帯域幅パーセンテージの合計は 100% を超えることはできません。 |
1 |
| Bandwidth |
string |
任意 |
キューがリージョン間トラフィックに使用できる絶対帯域幅値（単位：Mbit/s）。 トラフィックスケジューリングポリシーは最大 10 のキューをサポートしており、各キューに絶対帯域幅値を割り当てることができます。 たとえば、1 と入力した場合、そのキューに一致するトラフィックは最大 1 Mbit/s のリージョン間帯域幅を使用できます。 説明
トラフィックスケジューリングポリシー内のすべての割り当て済みキューの絶対帯域幅値の合計は、リージョン間帯域幅値を超えることはできません。 |
1 |
| Dscps |
array |
任意 |
キューが一致する DSCP 値。 トラフィックスケジューリングポリシーは最大 3 つのキューをサポートしており、各キューは最大 60 の DSCP 値に一致させることができます。複数の DSCP 値はカンマ（,）で区切ります。 |
|
|
integer |
任意 |
キューが一致する DSCP 値。 トラフィックスケジューリングポリシーは最大 3 つのキューをサポートしており、各キューは最大 60 の DSCP 値に一致させることができます。複数の DSCP 値はカンマ（,）で区切ります。 |
5 |
|
| QosQueueDescription |
string |
任意 |
キューの説明。 トラフィックスケジューリングポリシーは最大 10 のキューをサポートしており、各キューに説明を設定できます。 説明は空、または 1～256 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
desctest |
| ConsoleDryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値:
|
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| TrafficQosPolicyId |
string |
トラフィックスケジューリングポリシーの 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. | リクエストに指定された TransitRouterId が存在しません。 |
| 400 | IllegalParam.TransitRouterAttachmentId | TransitRouterAttachmentId is illegal. | リクエストで指定された TrInstance が無効です。 |
| 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. | 指定された帯域幅により、保証済み QoS 帯域幅の合計がリージョン間帯域幅割り当て値を超えています。 |
| 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. | リクエストで指定された RemainBandwidthPercent が無効です。 |
| 400 | IllegalParam.Bandwidth | Bandwidth is illegal | 帯域幅パッケージ ID が無効です。 |
| 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. | TransitRouterAttachment の現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 400 | InvalidParameter | Invalid parameter. | パラメーターが無効です。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | この操作を実行するために必須の権限がアカウントにありません。 |
| 400 | MissingParam.TransitRouterId | The parameter TransitrouterId is mandatory. | TransitRouterId パラメーターが不足しています。 |
| 400 | MissingParam.TransitRouterAttachmentId | The parameter TransitRouterAttachmentId is Missing. | TransitRouterAttachmentId パラメーターが不足しています。 |
| 400 | Forbidden.CDTServiceExpired | The CDT service is out of service. | 支払い遅延のため、Cloud Data Transfer (CDT) サービスが停止されています。サービスを更新してからもう一度お試しください。 |
| 400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | 現在のトランジットルータータイプでは、この操作はサポートされていません。 |
| 400 | OperationUnsupported.QosPolicyForLowLatencyLinkType | QoS Policy is not supported for Low Latency LinkType. | 低遅延リンクは QoS ポリシーの構成をサポートしていません。 |
| 400 | InvalidTransitRouterAttachmentId.NotFound | TransitRouterAttachmentId is not found. | リクエストに指定された TransitRouterAttachmentId が存在しません。 |
| 400 | IncorrectStatus.TransitRouterAttachmentId | The resource is not in a valid state for the attachment operation. | 添付ファイルが安定した状態ではないため、この操作はサポートされていません。 |
| 400 | InvalidOperation.QueueLinkTypeNotEqualsAttachmentLinkType | The operation is invalid because the link type of an existing QoS queue does not match the link type of the attachment. | 設定された QoS ポリシーにおいて、キューのリンクタイプがリージョン間接続のリンクタイプと異なります。 |
| 400 | ParamMismatch.BandwidthGuaranteeModeAndQueueSchedulingMode | The parameters BandwidthGuaranteeMode and QueueSchedulingMode are incompatible. | BandwidthGuaranteeMode パラメーターと QueueSchedulingMode パラメーターが一致しません。 |
| 400 | InvalidOperation.NotSupportHierarchicalQoS | The operation is invalid because the transit router does not support HierarchicalQoS. | 現在のトランジットルーターは、優先度スケジューリングモードの QoS ルートをサポートしていません。 |
| 400 | InvalidOperation.QueuesExceeded | The operation is invalid because the maximum queue quota for HierarchicalQoS has been exceeded. | 指定されたキューの数が多すぎます。 |
| 400 | ParamMismatch.QueueSchedulingModeAndBandwidth | The parameters QueueSchedulingMode and Bandwidth are incompatible. | QueueSchedulingMode パラメーターと Bandwidth パラメーターが一致しません。 |
| 400 | IllegalParam.QueueType | The parameter QueueType is illegal. | QueueType パラメーターが無効です。 |
| 400 | ParamMismatch.QueueTypeAndBandwidthPercent | The parameters QueueType and BandwidthPercent are incompatible. | QueueType パラメーターと BandwidthPercent パラメーターが一致しません。 |
| 400 | InvalidOperation.PriorityQueueExceeded | The operation is invalid because HierarchicalQoS supports only one priority queue. | 複数の優先度付きキューの作成はサポートされていません。 |
| 400 | ParamMismatch.QueueSchedulingModeAndQueueType | The parameters QueueSchedulingMode and QueueType are incompatible. | QueueSchedulingMode パラメーターと QueueType パラメーターが一致しません。 |
| 400 | ParamMismatch.QueueSchedulingModeAndLinkType | The parameters QueueSchedulingMode and LinkType are incompatible. | QueueSchedulingMode パラメーターと LinkType パラメーターが一致しません。 |
| 400 | IllegalParam.QueueSchedulingMode | The parameter QueueSchedulingMode is illegal. | QueueSchedulingMode パラメーターが無効です。 |
| 400 | InvalidOperation.TransitRouterNotSupportHierarchicalQoS | The operation is invalid because the transit router does not support HierarchicalQoS. | 現在のトランジットルーターは、優先度スケジューリングモードの QoS ルートをサポートしていません。 |
| 400 | InvalidParameter.TransitRouterAttachmentId | The specified parameter TransitRouterAttachmentId is invalid. | |
| 400 | InvalidParameter.TransitRouterId | The specified parameter TransitRouterId is invalid. | TransitRouterId パラメーターが無効です。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。