トラフィックマーキングポリシーにトラフィック分類ルールを追加します。

使用上の注意

AddTrafficMatchRuleToTrafficMarkingPolicyは非同期操作です。 リクエストを送信すると、リクエストIDが返されますが、操作はシステムバックグラウンドで実行中です。 ListTrafficMarkingPoliciesを呼び出して、トラフィック分類ルールのステータスを照会できます。

  • トラフィック分類ルールが [作成中] 状態の場合、トラフィック分類ルールは作成中です。 この場合、トラフィック分類ルールを照会できますが、他の操作は実行できません。
  • トラフィック分類ルールがアクティブ状態の場合、トラフィック分類ルールがトラフィックマーキングポリシーに追加されます。

デバッグ

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

リクエストパラメーター

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

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

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

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

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

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

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

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

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

TrafficMatchRules.N.MatchDscp Integer いいえ 5

パケットを照合するために使用される差別化サービスコードポイント (DSCP) 値。 有効な値: 0〜63。

トラフィック分類ルールは、指定されたDSCP値を含むパケットと一致します。 このパラメーターを設定しない場合、パケットはDSCP値に関係なく一致と見なされます。

説明 このパラメーターに指定するDSCP値は、パケットがリージョン間接続を介して送信される前に運ぶDSCP値です。
TrafficMatchRules.N.DstCidr String 任意 10.10.10.0/24

パケットの照合に使用される宛先CIDRブロック。

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

TrafficMatchRules.N.TrafficMatchRuleDescription String 任意 desktest

トラフィック分類ルールの説明。

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

TrafficMatchRules.N. プロトコル String 任意 HTTP

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

有効な値: HTTP、HTTPS、TCP、UDP、SSH、Telnet。 詳細については、CENコンソールにログインしてください。

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

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

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

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

  • 1などのポート番号を1つだけ入力した場合、宛先ポートが1のパケットと一致します。
  • 1と200の2つのポート番号を入力すると, 宛先ポートが1 ~ 200のパケットが一致します。
  • 2つのポート番号を入力し、そのうちの1つが-1の場合、もう1つのポート番号も-1である必要があります。 この場合、パケットは、宛先ポートに関係なく一致すると見なされる。
TrafficMatchRules.N.SrcCidr String 任意 192.168.10.0/24

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

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

TrafficMatchRules.N.SrcPortRange.N Integer いいえ 200

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

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

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

  • 1などのポート番号を1つだけ入力した場合、システムは送信元ポートが1であるパケットと一致します。
  • 1と200の2つのポート番号を入力すると、送信元ポートが1〜200のパケットが一致します。
  • 2つのポート番号を入力し、そのうちの1つが-1の場合、もう1つのポート番号も-1である必要があります。 この場合、パケットは、送信元ポートに関係なく一致すると見なされる。
N.TrafficMatchRuleName String 任意 nametest

トラフィック分類ルールの名前。

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

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 0876E54E-3E36-5C31-89F0-9EE8A9266F9A

リクエストの ID です。

例

リクエストの例

http(s):// [エンドポイント]/?Action=AddTraficMatchRuleToTrafficMarkingPolicy
&ClientToken=123e4567-e89b-12d3-a456-426 ****
&DryRun=false
&TrafficMarkingPolicyId=tm-u9nxup5kww5po8 ****
&TrafficMatchRules=[{"MatchDscp":5、"DstCidr":"10.10.10.0/24" 、"TrafficMatchRuleDescription":"desctest" 、"Protocol":"HTTP" 、"DstPortRange":[80] 、"SrcCidr":"192.168.10.0/24" 、"SrcPortRange":[200] 、"TrafficMatchRuleName":"nametest"}]
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<AddTraficMatchRuleToTrafficMarkingPolicyResponse>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</AddTraficMatchRuleToTrafficMarkingPolicyResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。