トラフィックマーキングポリシーを作成します。
使用上の注意
- Enterprise Editionトランジットルーターのみがトラフィックマーキングポリシーをサポートしています。
- CreateTrafficMarkingPolicyは非同期操作です。 リクエストを送信した後、システムはトラフィックマーキングポリシーIDを返しますが、操作はシステムのバックグラウンドでまだ実行されています。 ListTrafficMarkingPoliciesを呼び出して、トラフィックマーキングポリシーのステータスを照会できます。
- トラフィックマーキングポリシーが作成中の状態の場合、トラフィックマーキングポリシーは作成中です。 トラフィックマーキングポリシーはクエリできますが、他の操作は実行できません。
- トラフィックマーキングポリシーがアクティブ状態の場合、トラフィックマーキングポリシーが作成されます。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateTrafficMarkingPolicy |
実行する操作です。 値をCreateTrafficMarkingPolicyに設定します。 |
ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-426 **** |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。 説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
|
DryRun | Boolean | いいえ | false |
リクエストのみを事前チェックするかどうかを指定します。 有効な値:
|
TransitRouterId | String | 必須 | tr-8vbuqeo5h5pu3m01d **** |
トランジットルーターのID。 |
TrafficMarkingPolicyName | String | 任意 | nametest |
トラフィックマーキングポリシーの名前。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。 |
TrafficMarkingPolicyDescription | String | 任意 | desktest |
トラフィックマーキングポリシーの説明。 説明は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。 |
Priority | Integer | 〇 | 5 |
トラフィックマーキングポリシーの優先度。 有効な値: 1〜100。 トランジットルーターの各トラフィックマーキングポリシーの優先度値は一意である必要があります。 数字が小さいほど、優先度が高くなります。 |
MarkingDscp | Integer | 〇 | 5 |
トラフィック分類ルールに一致するパケットに追加される差別化サービスコードポイント (DSCP) 値。 有効な値: 0〜63。 トランジットルーターの各トラフィックマーキングポリシーのDSCP値は一意である必要があります。 |
TrafficMatchRules.N.MatchDscp | Integer | いいえ | 6 |
パケットの照合に使用されるDSCP値。 有効な値: 0〜63。 トラフィック分類ルールは、指定されたDSCP値を含むパケットと一致します。 このパラメーターを設定しない場合、パケットはDSCP値に関係なく一致と見なされます。 説明 このパラメーターに指定するDSCP値は、パケットがリージョン間接続を介して送信される前に運ぶDSCP値です。
一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにDSCP値を指定できます。 |
TrafficMatchRules.N.DstCidr | String | 任意 | 10.10.10.0/24 |
パケットの照合に使用される宛先CIDRブロック。 トラフィック分類ルールは、宛先IPアドレスが指定された宛先CIDRブロック内にあるパケットと一致します。 このパラメーターを設定しない場合、パケットはDSCP値に関係なく一致と見なされます。 一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとに宛先CIDRブロックを指定できます。 |
TrafficMatchRules.N.TrafficMatchRuleDescription | String | 任意 | desktest |
トラフィック分類ルールの説明。 一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとに説明を指定できます。 説明は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。 |
TrafficMatchRules.N. プロトコル | String | 任意 | HTTP |
パケットの照合に使用されるプロトコル。 有効な値: HTTP、HTTPS、TCP、UDP、SSH、Telnet。 詳細については、CENコンソールにログインしてください。 一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにプロトコルを指定できます。 |
TrafficMatchRules.N.DstPortRange.N | Integer | いいえ | 80 |
パケットの照合に使用される宛先ポート範囲。 有効な値: -1、65535に1。 トラフィック分類ルールは、宛先ポートが宛先ポート範囲内にあるパケットと一致する。 このパラメーターを設定しない場合、パケットはDSCP値に関係なく一致と見なされます。 最大2つのポート番号を入力できます。 次のルールに注意してください。
一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとに宛先ポート範囲を指定できます。 |
TrafficMatchRules.N.SrcCidr | String | 任意 | 192.168.10.0/24 |
パケットの照合に使用されるソースCIDRブロック。 トラフィック分類ルールは、ソースIPアドレスが指定されたソースCIDRブロック内にあるパケットと一致します。 このパラメーターを設定しない場合、送信元IPアドレスに関係なく、パケットは一致していると見なされます。 一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにソースCIDRブロックを指定できます。 |
TrafficMatchRules.N.SrcPortRange.N | Integer | いいえ | 1 |
パケットの照合に使用される送信元ポート範囲。 有効な値: -1、65535に1。 トラフィック分類ルールは、ソースポートがソースポート範囲内にあるパケットと一致する。 このパラメーターを設定しない場合、送信元ポートに関係なく、パケットは一致していると見なされます。 最大2つのポート番号を入力できます。 次のルールに注意してください。
一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにソースポート範囲を指定できます。 |
N.TrafficMatchRuleName | String | 任意 | nametest |
トラフィック分類ルールの名前。 一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとに名前を指定できます。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
TrafficMarkingPolicyId | String | tm-u9nxup5kww5po8 **** |
トラフィックマーキングポリシーのID。 |
RequestId | String | 0876E54E-3E36-5C31-89F0-9EE8A9266F9A |
リクエストの ID です。 |
例
リクエストの例
http(s)://[Endpoint]/? アクション=CreateTrafficMarkingPolicy
&ClientToken=123e4567-e89b-12d3-a456-426 ****
&DryRun=false
&TransitRouterId=tr-8vbuqeo5h5pu3m01d ****
&TrafficMarkingPolicyName=nametest
&TrafficMarkingPolicyDescription=desctest
&優先度=5
&MarkingDscp=5
&TrafficMatchRules=[{"MatchDscp":6,"DstCidr":"10.10.10.0/24","TrafficMatchRuleDescription":"desktest","Protocol":"HTTP","DstPortRange":[80],"SrcCidr":"Ruchname"" "" Matffle1"
&共通リクエストパラメータ
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateTrafficMarkingPolicyResponse>
<TrafficMarkingPolicyId>tm-u9nxup5kww5po8 ****</TrafficMarkingPolicyId>
<RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</CreateTrafficMarkingPolicyResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TrafficMarkingPolicyId" : "tm-u9nxup5kww5po8 ****" 、
"RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidTransitRouterId.NotFound | TransitRouterIdが見つかりません。 | トランジットルーターのIDが無効な場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。