トラフィックマーキングポリシーを作成します。

使用上の注意

  • Enterprise Editionトランジットルーターのみがトラフィックマーキングポリシーをサポートしています。
  • CreateTrafficMarkingPolicyは非同期操作です。 リクエストを送信した後、システムはトラフィックマーキングポリシーIDを返しますが、操作はシステムのバックグラウンドでまだ実行されています。 ListTrafficMarkingPoliciesを呼び出して、トラフィックマーキングポリシーのステータスを照会できます。
    • トラフィックマーキングポリシーが作成中の状態の場合、トラフィックマーキングポリシーは作成中です。 トラフィックマーキングポリシーはクエリできますが、他の操作は実行できません。
    • トラフィックマーキングポリシーがアクティブ状態の場合、トラフィックマーキングポリシーが作成されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 CreateTrafficMarkingPolicy

実行する操作です。 値をCreateTrafficMarkingPolicyに設定します。

ClientToken String 任意 123e4567-e89b-12d3-a456-426 ****

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

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
DryRun Boolean いいえ false

リクエストのみを事前チェックするかどうかを指定します。 有効な値:

  • true: リクエストはチェックされますが、トラフィックマーキングポリシーは作成されません。 システムは、必要なパラメーター、リクエスト形式、およびサービス制限をチェックします。 リクエストが事前チェックに合格しなかった場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。
  • false (デフォルト): リクエストを送信します。 リクエストがチェックに合格した場合、トラフィックマーキングポリシーが作成されます。
TransitRouterId String 必須 tr-8vbuqeo5h5pu3m01d ****

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

TrafficMarkingPolicyName String 任意 nametest

トラフィックマーキングポリシーの名前。

名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

TrafficMarkingPolicyDescription String 任意 desktest

トラフィックマーキングポリシーの説明。

説明は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。

Priority Integer 5

トラフィックマーキングポリシーの優先度。 有効な値: 1100

トランジットルーターの各トラフィックマーキングポリシーの優先度値は一意である必要があります。 数字が小さいほど、優先度が高くなります。

MarkingDscp Integer 5

トラフィック分類ルールに一致するパケットに追加される差別化サービスコードポイント (DSCP) 値。 有効な値: 063

トランジットルーターの各トラフィックマーキングポリシーのDSCP値は一意である必要があります。

TrafficMatchRules.N.MatchDscp Integer いいえ 6

パケットの照合に使用されるDSCP値。 有効な値: 063

トラフィック分類ルールは、指定された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

パケットの照合に使用されるプロトコル。

有効な値: HTTPHTTPSTCPUDPSSHTelnet。 詳細については、CENコンソールにログインしてください。

一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにプロトコルを指定できます。

TrafficMatchRules.N.DstPortRange.N Integer いいえ 80

パケットの照合に使用される宛先ポート範囲。 有効な値: -1655351

トラフィック分類ルールは、宛先ポートが宛先ポート範囲内にあるパケットと一致する。 このパラメーターを設定しない場合、パケットはDSCP値に関係なく一致と見なされます。

最大2つのポート番号を入力できます。 次のルールに注意してください。

  • 1などのポート番号を1つだけ入力した場合、宛先ポートが1のパケットと一致します。
  • 1と200の2つのポート番号を入力すると, 宛先ポートが1 ~ 200のパケットが一致します。
  • 2つのポート番号を入力し、そのうちの1つが-1の場合、もう1つのポート番号も-1である必要があります。 この場合、全ての宛先ポートを有するパケットが一致する。

一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとに宛先ポート範囲を指定できます。

TrafficMatchRules.N.SrcCidr String 任意 192.168.10.0/24

パケットの照合に使用されるソースCIDRブロック。

トラフィック分類ルールは、ソースIPアドレスが指定されたソースCIDRブロック内にあるパケットと一致します。 このパラメーターを設定しない場合、送信元IPアドレスに関係なく、パケットは一致していると見なされます。

一度に最大50のトラフィック分類ルールを作成できます。 トラフィック分類ルールごとにソースCIDRブロックを指定できます。

TrafficMatchRules.N.SrcPortRange.N Integer いいえ 1

パケットの照合に使用される送信元ポート範囲。 有効な値: -1655351

トラフィック分類ルールは、ソースポートがソースポート範囲内にあるパケットと一致する。 このパラメーターを設定しない場合、送信元ポートに関係なく、パケットは一致していると見なされます。

最大2つのポート番号を入力できます。 次のルールに注意してください。

  • 1などのポート番号を1つだけ入力した場合、システムは送信元ポートが1であるパケットと一致します。
  • 1と200の2つのポート番号を入力すると、送信元ポートが1〜200のパケットが一致します。
  • 2つのポート番号を入力し、そのうちの1つが-1の場合、もう1つのポート番号も-1である必要があります。 この場合、全ての送信元ポートを有するパケットがマッチングされる。

一度に最大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 エラーセンター」をご参照ください。