すべてのプロダクト
Search
ドキュメントセンター

Cloud Enterprise Network:CreateFlowlog

最終更新日:Sep 09, 2025

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

操作説明

フローログを使用すると、トランジットルーターインスタンスとネットワークインスタンス接続を介して送信されるトラフィックをキャプチャできます。ネットワークインスタンス接続には、リージョン間接続、VPC接続、VPN接続、ECR接続、および VBR 接続が含まれます。フローログを作成する前に、次の点に注意してください。

  • Enterprise Edition トランジットルーターのみがフローログをサポートしています。

  • リージョン間接続の場合、フローログはトランジットルーターからのアウトバウンドトラフィックのみをキャプチャします。インバウンドトラフィックはキャプチャされません。

    たとえば、米国 (シリコンバレー) リージョンの Elastic Compute Service (ECS) インスタンスが Cloud Enterprise Network (CEN) を介して米国 (バージニア北部) リージョンの ECS インスタンスにアクセスするとします。米国 (バージニア北部) リージョンのトランジットルーターのフローログを作成すると、Simple Log Service コンソールで、米国 (バージニア北部) リージョンの ECS インスタンスから米国 (シリコンバレー) リージョンの ECS インスタンスに送信されたメッセージを表示できます。ただし、米国 (シリコンバレー) リージョンの ECS インスタンスから米国 (バージニア北部) リージョンの ECS インスタンスに送信されたメッセージは表示できません。これらのメッセージを表示するには、米国 (シリコンバレー) リージョンのトランジットルーターのフローログも作成する必要があります。

  • フローログが VPC 接続のトラフィックをキャプチャする場合、トランジットルーターの Elastic Network Interface (ENI) を介して送信されるトラフィックのみをキャプチャします。VPC 内の他の ENI を介して送信されるトラフィックをキャプチャするには、「VPC フローログの概要」をご参照ください。

  • CreateFlowlog は非同期操作です。リクエストを送信すると、システムはフローログ ID を返します。ただし、フローログはすぐに作成されません。システムはバックグラウンドでフローログを作成します。DescribeFlowlogs 操作を呼び出して、フローログのステータスをクエリできます。

    • フローログが 作成中 状態の場合、作成中です。この状態では、フローログをクエリすることしかできません。

    • フローログが アクティブ 状態の場合、作成済みです。

前提条件

リソースのフローログを作成する前に、リソースが作成済みであることを確認してください。リソースを作成するには、次のトピックをご参照ください。

今すぐお試しください

この 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 文字のみを含めることができます。

説明

このパラメーターを指定しない場合、システムはリクエスト ID をクライアントトークンとして自動的に使用します。リクエスト ID はリクエストごとに異なる場合があります。

123e4567-e89b-12d3-a456-42665544****

RegionId

string

必須

フローログのリージョン ID。

子インスタンスリージョンの照会 操作を呼び出して、リージョン ID を取得できます。

cn-hangzhou

FlowLogName

string

任意

フローログの名前。

名前は空にするか、1 ~ 128 文字の長さにできます。 `http://` または `https://` で始めることはできません。

myFlowlog

Description

string

任意

フローログの説明。

説明は空にするか、1 ~ 256 文字の長さにできます。 `http://` または `https://` で始めることはできません。

myFlowlog

CenId

string

必須

CEN インスタンスの ID。

cen-7qthudw0ll6jmc****

ProjectName

string

任意

キャプチャされたトラフィックを保存するために使用されるプロジェクト。

  • 現在のリージョンにプロジェクトを既に作成している場合は、プロジェクトの名前を入力します。

  • 現在のリージョンにプロジェクトを作成していない場合は、プロジェクトのカスタム名を指定できます。システムはプロジェクトを自動的に作成します。

    プロジェクト名は、Alibaba Cloud リージョン内でグローバルに一意である必要があり、プロジェクトの作成後に変更することはできません。名前は次の要件を満たしている必要があります。

    • 名前はグローバルに一意である必要があります。

    • 小文字、数字、およびハイフン (-) のみを含めることができます。

    • 小文字または数字で開始および終了する必要があります。

    • 3 ~ 63 文字の長さである必要があります。

flowlog-project

LogStoreName

string

任意

キャプチャされたトラフィックを保存するために使用される 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}

Tag

array<object>

任意

タグ。

呼び出しごとに最大 20 個のタグを追加できます。

object

任意

タグ。

呼び出しごとに最大 20 個のタグを追加できます。

Key

string

任意

タグキー。

タグキーは空の文字列にすることはできません。タグキーは最大 64 文字の長さにでき、aliyun または acs: で始めることはできません。 http:// または https:// を含めることはできません。

最大 20 個のタグキーを指定できます。

TagKey

Value

string

任意

タグ値。

タグ値は空の文字列にするか、最大 128 文字の文字列にすることができます。 aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

各タグキーには一意のタグ値が必要です。最大 20 個のタグ値を指定できます。

TagValue

レスポンスフィールド

フィールド

説明

object

レスポンス。

RequestId

string

リクエスト ID。

54B48E3D-DF70-471B-AA93-08E683A1B457

Success

string

呼び出しが成功したかどうかを示します。

  • 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.
400 SourceProjectNotExist The Source Project or logstore does not exist.
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.
400 Flowlog.AlreayExist This attachment already has existed flowlog instance.
400 IllegalParam.TransitRouterAttachmentId TransitRouterAttachmentId is illegal.
400 InvalidTransitRouterAttachmentId.NotFound The TransitRouterAttachmentId is not found.
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.
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.
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.
403 NoPermission.AliyunServiceRoleForTRFlowLog You are not authorized to create service linked role AliyunServiceRoleForTRFlowLog.

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

変更履歴

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