トランジットルーターでフローログを設定 - Cloud Enterprise Network (CEN) - Alibaba Cloud - Cloud Enterprise Network

フローログを作成します。

操作説明

フローログを使用すると、トランジットルーターインスタンスおよびネットワークインスタンス接続（リージョン間接続、VPC 接続、VPN 接続、ECR 接続、VBR 接続）によって送信されるトラフィック情報をキャッチできます。フローログを作成する前に、以下の点にご注意ください。

Enterprise Edition のトランジットルーターのみがフローログの作成をサポートしています。
リージョン間接続のトラフィック情報については、フローログはトランジットルーターのアウトバウンドトラフィックのみをキャッチします。トランジットルーターのインバウンドトラフィックはキャッチされません。

たとえば、米国（シリコンバレー）リージョンの Elastic Computing Service（ECS）インスタンスが、CEN を介して米国（バージニア）リージョンの ECS インスタンスにアクセスするとします。米国（バージニア）リージョンのトランジットルーターにフローログを設定した後、Simple Log Service コンソールで米国（バージニア）の ECS インスタンスから米国（シリコンバレー）の ECS インスタンスへ送信されたパケット情報を確認できます。ただし、米国（シリコンバレー）の ECS インスタンスから米国（バージニア）の ECS インスタンスへ送信されたパケット情報は確認できません。米国（シリコンバレー）の ECS インスタンスから米国（バージニア）の ECS インスタンスへ送信されたパケット情報を確認するには、米国（シリコンバレー）リージョンのトランジットルーターにフローログを設定してください。
フローログが VPC 接続のトラフィック情報をキャッチする場合、トランジットルーターのエラスティックネットワークインターフェイス（ENI）によって送信されるトラフィックのみをキャッチします。VPC 内の他の ENI のトラフィック情報を確認するには、「VPC フローログの概要」をご参照ください。
CreateFlowlog 操作は非同期です。リクエストを送信すると、バックグラウンドでフローログが作成されている間に、システムからフローログ ID が返されます。DescribeFlowlogs 操作を呼び出して、フローログのステータスをクエリできます。
- フローログが Creating 状態の場合、フローログは作成中です。この状態では、クエリ操作のみを実行できます。
- フローログが Active 状態の場合、フローログは作成済みです。

事前準備

リソースのフローログを作成する前に、必須のリソースが作成されていることを確認してください。各リソースの作成方法については、以下をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:CreateFlowlog

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API 呼び出しの RequestId を ClientToken として自動的に使用します。RequestId は API 呼び出しごとに異なる場合があります。	123e4567-e89b-12d3-a456-42665544****
RegionId	string	必須	フローログのリージョン ID。 DescribeChildInstanceRegions 操作を呼び出して、リージョン ID をクエリできます。	cn-hangzhou
FlowLogName	string	任意	フローログの名前。名前は空でもよく、長さは 1～128 文字で、http:// または https:// で始まることはできません。	myFlowlog
Description	string	任意	フローログの説明。説明は空でもよく、長さは 1～256 文字で、http:// または https:// で始まることはできません。	myFlowlog
CenId	string	必須	Cloud Enterprise Network（CEN）インスタンスの ID。	cen-7qthudw0ll6jmc****
ProjectName	string	任意	キャッチされたトラフィックを保存するプロジェクト。現在のリージョンにすでにプロジェクトを作成している場合は、既存のプロジェクトの名前を入力します。現在のリージョンにプロジェクトを作成していない場合は、プロジェクトのカスタム名を指定します。システムが自動的にプロジェクトを作成します。プロジェクト名は Alibaba Cloud リージョン内でグローバルに一意である必要があり、作成後は変更できません。命名ルールは以下のとおりです。プロジェクト名はグローバルに一意である必要があります。名前には小文字、数字、ハイフン（-）のみを含めることができます。名前の先頭と末尾は小文字または数字である必要があります。名前の長さは 3～63 文字である必要があります。	flowlog-project
LogStoreName	string	任意	キャッチされたトラフィックを保存する Logstore。現在のリージョンにすでに Logstore を作成している場合は、既存の Logstore の名前を入力します。現在のリージョンに Logstore を作成していない場合は、Logstore のカスタム名を指定します。システムが自動的に Logstore を作成します。 Logstore の命名ルールは以下のとおりです。 Logstore 名は同じプロジェクト内で一意である必要があります。名前には小文字、数字、ハイフン（-）、アンダースコア（_）のみを含めることができます。名前の先頭と末尾は小文字または数字である必要があります。名前の長さは 3～63 文字である必要があります。	flowlog-logstore
Interval	integer	任意	フローログのキャプチャウィンドウの持続時間。単位：秒。有効な値：60 および 600。デフォルト値：600。	600
TransitRouterAttachmentId	string	任意	VPC 接続、VPN 接続、VBR 接続、ECR 接続、またはリージョン間接続の ID。トランジットルーターインスタンスにフローログを設定する場合は、このパラメーターを空のままにします。	tr-attach-r6g0m3epjehw57****
TransitRouterId	string	任意	トランジットルーターインスタンスの ID。	tr-bp1rmwxnk221e3fas****
LogFormatString	string	任意	カスタムフローログレコードフィールドを定義する文字列。フォーマットは以下のように定義されます。 `${field 1}${field 2}${field 3}...${field n}` このパラメーターを空のままにすると、すべてのデフォルトフィールドが記録されます。このパラメーターを指定する場合、`${srcaddr}${dstaddr}${bytes}` は必須フィールドであるため、文字列は `${srcaddr}${dstaddr}${bytes}` で始まる必要があります。サポートされているすべてのフローログフィールドについては、「フローログの設定」をご参照ください。	${srcaddr}${dstaddr}${bytes}
Tag	array<object>	任意	タグ情報。一度に最大 20 個のタグを指定できます。
	object	任意	タグ情報。一度に最大 20 個のタグを指定できます。
Key	string	任意	リソースのタグキー。指定した場合、タグキーを空文字列にすることはできません。タグキーの長さは最大 64 文字で、`aliyun` または `acs:` で始まることはできません。`http://` または `https://` を含めることはできません。一度に最大 20 個のタグキーを指定できます。	TagKey
Value	string	任意	リソースのタグ値。指定した場合、タグ値を空にすることはできません。タグ値の長さは最大 128 文字で、aliyun または acs: で始まることはできません。http:// または https:// を含めることはできません。各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。	TagValue

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	54B48E3D-DF70-471B-AA93-08E683A1B457
Success	string	API 呼び出しが成功したかどうかを示します。 true: 成功。 false: 失敗した。	true
FlowLogId	string	フローログの ID。	flowlog-m5evbtbpt****

例

成功レスポンス

JSONJSON

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B457",
  "Success": "true。",
  "FlowLogId": "flowlog-m5evbtbpt****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	パラメーターで指定されたプロジェクトまたは Logstore が存在しません。
400	SourceProjectNotExist	The Source Project or logstore does not exist.	SourceProject または Logstore が存在しません。
400	OperationUnsupported.action	This action is not support.	現在のリージョンではこの操作はサポートされていません。
400	RuleExist	The rule has already existed.	ルールはすでに存在します。
400	QuotaExceeded.FlowlogCount	This user has reached the maximum instance number of flowlog.	フローログ数が上限に達しました。
400	InvalidFlowlogId.exist	This cenId already has flowlog instance existed.	現在の CEN インスタンスには既にフローログが存在します。この操作は実行できません。
400	Flowlog.AlreayExist	This attachment already has existed flowlog instance.	フローログはすでに存在するため、再度作成することはできません。
400	IllegalParam.TransitRouterAttachmentId	TransitRouterAttachmentId is illegal.	リクエストで指定された TrInstance が無効です。
400	InvalidTransitRouterAttachmentId.NotFound	The TransitRouterAttachmentId is not found.	リクエストに指定された TransitRouterAttachmentId が存在しません。
400	IncorrectStatus.flowlog	This action is not allowed in the current flow log status.	現在のフローログのステータスではこのポート操作を実行できません。後でもう一度お試しください。
400	InvalidOperation.TransitRouterNotExist	Operation is invalid because the transit router not exist.	トランジットルーターが存在しません。
400	IncorrectStatus.TransitRouterAttachmentId	The resource is not in a valid state for the attachment operation.	添付ファイルが安定した状態ではないため、この操作はサポートされていません。
400	ProjectExist	Project already exist, please try a different project name.	ログプロジェクトは既に存在します。別のプロジェクト名を使用してください。
400	InvalidParameter.ProjectName	Project name is invalid or does not belong to specified region.	プロジェクト名が無効です。
400	IncorrectStatus.TrFlowlog	Flowlog status for specified TransitRouter is invalid for this operation.	指定されたトランジットルーターのフローログ構成が無効な状態です。
400	OperationInvalid.IncompatibleFlowlogExist	Operation is invalid because incompatible flowlog config exists.	互換性のないフローログ構成が存在します。削除してから再試行してください。
400	InvalidParameter.LogFormatString	LogFormatString is invalid.	指定されたログフォーマットが無効です。
400	InvalidParameter.LogStoreName	Specified LogStore name is invalid.	Logstore 名が無効です。
400	OperationFailed.InvalidLogInfo	The entered log service information is invalid. Check whether the ProjectName and LogStoreName are correct, and whether Log Service has been activated.	指定された Log Service 情報が無効です。ProjectName および LogStoreName が正しいこと、ならびに Simple Log Service が有効化されていることを確認してください。
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	トランジットルーターが無効な状態です。
400	InvalidParameter	Invalid parameter.	パラメーターが無効です。
400	Unauthorized	The AccessKeyId is unauthorized.	この操作を実行するために必須の権限がアカウントにありません。
400	InvalidParameter.CenId	The specified parameter CenId is invalid.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	タグ値パラメーターが無効です。
400	InvalidParameter.TransitRouterAttachmentId	The specified parameter TransitRouterAttachmentId is invalid.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	TransitRouterId パラメーターが無効です。
403	NoPermission.AliyunServiceRoleForTRFlowLog	You are not authorized to create service linked role AliyunServiceRoleForTRFlowLog.	サービスリンクロール AliyunServiceRoleForTRFlowLog を作成する権限がありません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。