QoS (Quality of Service) ポリシーでキューを作成し、より細かい粒度でネットワークトラフィックを管理し、サービスパフォーマンスを向上させ、サービスレベルアグリーメント (SLA) を満たします。
操作説明
CreateCenInterRegionTrafficQosQueue は非同期操作です。 リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。 ListCenInterRegionTrafficQosPolicies 操作を呼び出して QoS ポリシーのステータスをクエリし、キューのステータスを判断できます。 この操作を呼び出すときは、TrafficQosPolicyId パラメーターを設定する必要があります。
-
QoS ポリシーが 変更中 状態の場合、キューは作成中です。 この場合、QoS ポリシーとキューをクエリできますが、他の操作は実行できません。
-
QoS ポリシーが アクティブ 状態の場合、キューは作成済みです。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:CreateCenInterRegionTrafficQosQueue |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンがユニークであることを確認する必要があります。 トークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは自動的にリクエスト ID をクライアントトークンとして使用します。 リクエスト ID はリクエストごとに異なる場合があります。 |
123e4567-e89b-12d3-a456-426**** |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。 有効な値:
|
false |
| QosQueueName |
string |
任意 |
キューの名前。 名前は空、または 1~128 文字の長さで、http:// または https:// で始めることはできません。 |
nametest |
| QosQueueDescription |
string |
任意 |
キューの説明。 このパラメーターはオプションです。 説明を入力する場合、1~256 文字の長さで、http:// または https:// で始めることはできません。 |
desctest |
| RemainBandwidthPercent |
string |
任意 |
キューに割り当てることができるリージョン間帯域幅の最大パーセンテージ。
|
20 |
| Bandwidth |
integer |
任意 |
キューに割り当てることができる最大絶対帯域幅値。 単位:Mbit/s。
|
20 |
| TrafficQosPolicyId |
string |
必須 |
QoS ポリシーの ID。 |
qos-qdvybn468kaoxx**** |
| Dscps |
array |
必須 |
現在のキューに一致する Differentiated Services Code Point (DSCP) 値。 各呼び出しで、キューに最大 20 個の DSCP 値を指定できます。 DSCP 値はコンマ (,) で区切ります。 |
|
|
integer |
任意 |
現在のキューに一致する DSCP 値。 各呼び出しで、キューに最大 20 個の DSCP 値を指定できます。 DSCP 値はコンマ (,) で区切ります。 |
5 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答。 |
||
| QosQueueId |
string |
キューの ID。 |
qos-queue-irqhi8k5fdyuu5**** |
| RequestId |
string |
リクエストの ID。 |
845F66F6-5C27-53A1-9428-B859086237B2 |
例
成功レスポンス
JSONJSON
{
"QosQueueId": "qos-queue-irqhi8k5fdyuu5****",
"RequestId": "845F66F6-5C27-53A1-9428-B859086237B2"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalParam.RemainBandwidthPercent | The specified RemainBandwidthPercent is invalid. | |
| 400 | IncorrectStatus.TrafficQosPolicy | The status of TrafficQosPolicy is incorrect. | |
| 400 | Duplicated.Dscps | The parameter Dscps are duplicated. | |
| 400 | InvalidDescription | Description is invalid. | |
| 400 | InvalidName | Name is invalid. | |
| 400 | MissingParam.Bandwidth | The parameter Bandwidth is mandatory. | |
| 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 | MissingParam.RemainBandwidthPercent | RemainBandwidthPercent is missing. | |
| 400 | IllegalParam.Bandwidth | Bandwidth is illegal | |
| 400 | InvalidParameter | Invalid parameter. | |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | |
| 400 | MissingParam.TrafficQosPolicyId | The parameter TrafficQosPolicyId is mandatory. | |
| 400 | Forbidden.CDTServiceExpired | The CDT service is out of service. | |
| 404 | InvalidTrafficQosPolicyId.NotFound | The specified TrafficQosPolicyId is not found. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。