リージョン間通信のサービス品質 (QoS) ポリシーを作成します。
使用上の注意
-
Enterprise Editionトランジットルーターで作成されたリージョン間接続のみがQoSポリシーをサポートしています。
-
QoSポリシーは、Enterprise Editionトランジットルーターのアウトバウンドトラフィックにのみ適用されます。
中国 (杭州) リージョンと中国 (青島) リージョンの間にリージョン間接続を作成し、中国 (杭州) リージョンのトランジットルーターと中国 (青島) リージョンのトランジットルーターのQoSポリシーを作成した場合、QoSポリシーは中国 (杭州) から中国 (青島) に流れるネットワークトラフィックにのみ適用されます。 QoSポリシーは、帯域幅リソースを異なるサービスに割り当てる。
- CreateCenInterRegionTrafficQosPolicyは同期操作です。 リクエストを送信すると、システムはQoSポリシーIDを返しますが、操作はシステムバックグラウンドで実行されます。 ListCenInterRegionTrafficQosPoliciesを呼び出して、QoSポリシーのステータスを照会できます。
- QoSポリシーが作成中の状態の場合、QoSポリシーは作成中です。 QoSポリシーを照会できますが、他の操作は実行できません。
- QoSポリシーがアクティブ状態の場合、QoSポリシーが作成されます。
前提条件
CreateCenInterRegionTrafficQosPolicy操作を呼び出す前に、次の要件が満たされていることを確認してください。
- リージョン間接続が作成されます。 詳細については、「CreateTransitRouterPeerAttachment」をご参照ください。
- トラフィックマーキングポリシーが作成されます。 詳細については、「CreateTrafficMarkingPolicy」をご参照ください。
デバッグ
リクエストパラメーター
| 項目 | データ型 | 必須／任意 | 例: | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | CreateCenInterRegionTrafficQosPolicy |
実行する操作です。 値をCreateCenInterRegionTrafficQosPolicyに設定します。 |
| ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-426655 **** |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、値が異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 |
| DryRun | Boolean | いいえ | false |
リクエストのみをチェックするかどうかを指定します。 有効な値：
|
| TransitRouterId | String | 必須 | tr-8vbuqeo5h5pu3m01d **** |
トランジットルーターのID。 |
| TransitRouterAttachmentId | String | 必須 | tr-attach-r6g0m3epjehw57 **** |
リージョン間接続のID。 |
| TrafficQosPolicyName | String | 任意 | nametest |
QoSポリシーの名前。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は文字である必要があります。 |
| TrafficQosPolicyDescription | String | 任意 | desktest |
QoSポリシーの説明。 説明は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。 |
| N.QosQueueName TrafficQosQueues. | String | 任意 | nametest |
現在のキューの名前。 各QoSポリシーは、最大3つのキューをサポートします。 各キューの名前を指定できます。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は文字である必要があります。 |
| TrafficQosQueues.N. 残り帯域幅パーセント | String | いいえ | 1 |
現在のキューに割り当てることができる帯域幅リソースの割合。 各QoSポリシーは、最大3つのキューをサポートします。 各キューの帯域幅リソースの割合を指定できます。 1を入力すると、現在のキューが帯域幅リソースの最大1% を消費できることを示します。 説明 QoSポリシー内のすべてのキューのパーセンテージ値の合計は、100% を超えることはできません。
|
| TrafficQosQueues.N.Dscps.N | Integer | いいえ | 5 |
現在のキューと一致する差別化サービスコードポイント (DSCP) 値。 各QoSポリシーは、最大3つのキューをサポートします。 各キューに最大60個のDSCP値を指定できます。 DSCP値はコンマ (,) で区切ります。 |
| TrafficQosQueues.N.QosQueueDescription | String | 任意 | desktest |
現在のキューの説明。 各QoSポリシーは、最大3つのキューをサポートします。 各キューに説明を追加できます。 説明は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。 |
レスポンスパラメーター
| 項目 | データ型 | 例: | 説明 |
|---|---|---|---|
| TrafficQosPolicyId | String | qos-eczzew0v1kzrb5 **** |
QoSポリシーのID。 |
| RequestId | String | 6DF9A765-BCD2-5C7E-8C32-C35C8A361A39 |
リクエストの ID です。 |
例
リクエストの例
http(s)://[Endpoint]/? アクション=CreateCenInterRegionTrafficQosPolicy
&ClientToken=123e4567-e89b-12d3-a456-426655 ****
&DryRun=false
&TransitRouterId=tr-8vbuqeo5h5pu3m01d ****
&TransitRouterAttachmentId=tr-attach-r6g0m3epjehw57 ****
&TrafficQosPolicyName=nametest
&TrafficQosPolicyDescription=desctest
&TrafficQosQueues=[{"QosQueueName":"nametest","RemainBandwidthPercent":"1","Dscps":[5],"QosQueueDescription":"desctest"}]
&共通リクエストパラメータ正常に処理された場合のレスポンス例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateCenInterRegionTrafficQosPolicyResponse>
<TrafficQosPolicyId>qos-eczzew0v1kzrb5 ****</TrafficQosPolicyId>
<RequestId>6DF9A765-BCD2-5C7E-8C32-C35C8A361A39</RequestId>
</CreateCenInterRegionTrafficQosPolicyResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TrafficQosPolicyId" : "qos-eczzew0v1kzrb5 ****" 、
"RequestId" : "6DF9A765-BCD2-5C7E-8C32-C35C8A361A39"
}エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。