APIを使用するには、APIエンドポイントとトークンなどが必要です。API使用準備を参照して、API使用に必要な情報を準備します。
ロガーとロギングポートAPIはnetwork
タイプのエンドポイントを利用します。正確なエンドポイントは、トークン発行応答のserviceCatalog
を参照してください。
タイプ | リージョン | エンドポイント |
---|---|---|
network | 韓国(パンギョ)リージョン 韓国(ピョンチョン)リージョン |
https://kr1-api-network-infrastructure.nhncloudservice.com https://kr2-api-network-infrastructure.nhncloudservice.com |
APIレスポンスにガイドに記載されていないフィールドが表示される場合があります。このようなフィールドは、NHN Cloudの内部用途で使用し、予告なく変更される可能性があるため、使用しないでください。
GET /v2.0/flowlog-loggers
X-Auth-Token: {tokenId}
このAPIはリクエスト本文を要求しません。
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
id | Query | UUID | - | 照会するフローログロガーID |
name | Query | String | - | 照会するフローログロガーの名前 |
resource_type | Query | String | - | 照会するフローログロガーのリソースタイプ |
resource_id | Query | String | - | 照会するフローログロガーのリソースID |
filter | Query | String | - | 照会するフローログロガーのフィルタ |
aggregation_interval | Query | Integer | - | 照会するフローログロガーの集計間隔 |
storage_type | Query | String | - | 照会するフローログロガーのストレージタイプ |
log_format | Query | String | - | 照会するフローログロガーの保存フォーマット |
compression_type | Query | String | - | 照会するフローログロガーの圧縮タイプ |
partitioned_period | Query | String | - | 照会するフローログロガーのパーティション周期 |
status | Query | String | - | 照会するフローログロガーの状態 |
名前 | 種類 | 形式 | 説明 |
---|---|---|---|
flowlog_loggers | Body | Array | フローログオブジェクトリスト |
flowlog_loggers.name | Body | String | フローログロガーの名前 |
flowlog_loggers.resource_type | Body | String | フローログロガーの収集対象リソースタイプ。 VPC , SUBNET , PORT のいずれか |
flowlog_loggers.resource_id | Body | UUID | フローログロガーの収集対象リソースID |
flowlog_loggers.filter | Body | String | フローログロガーの収集対象フィルタ。 ALL , ACCEPT , DROP のいずれか* ACCEPT は通信が許可されたパケットのみをキャプチャ* DROP は通信がブロックされたパケットのみをキャプチャ* ALL は通信が許可・ブロックされたパケットをすべてキャプチャ |
flowlog_loggers.aggregation_interval | Body | Integer | フローログロガーが収集したデータを合算・集計してストレージにファイルとして記録する周期。単位は分。ストレージにファイルが該当値を周期で作成される。 |
flowlog_loggers.connection_setup_only | Body | Boolean | この値がtrue の場合、接続確立を試みたパケットのみを収集。true`に設定すると、以下のように収集対象が限定されます。* TCPの場合、TCP stateが確立されている場合は収集しない。 * UDP/ICMPの場合はレスポンスパケットを収集しない |
flowlog_loggers.storage_type | Body | Boolean | フローログロガーのストレージタイプ。現在はOBS のみサポート。 |
flowlog_loggers.storage_url | Body | Boolean | フローログロガーのストレージアドレス |
flowlog_loggers.log_format | Body | Boolean | フローログロガーが保存するファイルのフォーマット。 CSV , PARQUET ファイル形式可能。 |
flowlog_loggers.compression_type | Body | Boolean | フローログロガーが保存するファイルの圧縮形式。RAW , GZIP 圧縮形式可能。現在はRAW のみサポート。 |
flowlog_loggers.customized_field | Body | String | フローログロガーがファイルに記録するフィールド。現在はサポートしない機能。 |
flowlog_loggers.partition_period | Body | Boolean | フローログロガーがストレージにファイルを保存する際、フォルダ作成構造を意味する。HOUR とDAY をサポート。 * DAY を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY} フォルダを作成して日付を区切る* HOUR を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY}/{HOUR} までフォルダを作成して時間別に区切る |
flowlog_loggers.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。 |
flowlog_loggers.description | Body | Boolean | フローログロガーの説明 |
flowlog_loggers.status | Body | Enum | フローログロガーの状態 |
flowlog_loggers.created_at | Body | Date | フローログロガーを作成した時間 |
flowlog_loggers.updated_at | Body | Date | フローログロガーが修正された時間 |
flowlog_loggers.error_type | Body | String | フローログロガーにエラーが発生した場合、エラー理由を表示。 詳細はページ下部のエラータイプをご確認ください。 |
{
"flowlog_loggers": [
{
"status": "ACTIVE",
"connection_setup_only": false,
"description": "",
"partition_period": "DAY",
"resource_id": "12799b52-0c81-4820-8fe6-b4963989ffe1",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-07-29 09:21:09",
"error_type": "",
"updated_at": "2024-08-04 05:11:05",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"id": "3e84619a-1e49-4b19-b353-a15f7d278f94",
"filter": "ACCEPT",
"storage_type": "OBS",
"aggregation_interval": 10,
"admin_state_up": true,
"log_format": "CSV",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"project_id": "419a823563124dc5b5627f5e79db8174",
"compression_type": "RAW",
"resource_type": "PORT",
"name": "test"
},
{
"status": "ACTIVE",
"connection_setup_only": false,
"description": "KR2test",
"partition_period": "HOUR",
"resource_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-08-04 05:17:03",
"error_type": "",
"updated_at": "2024-08-04 05:19:04",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"id": "4a9912b9-7bbc-48f0-b066-fc165486f49d",
"filter": "ALL",
"storage_type": "OBS",
"aggregation_interval": 1,
"admin_state_up": true,
"log_format": "CSV",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"project_id": "419a823563124dc5b5627f5e79db8174",
"compression_type": "RAW",
"resource_type": "PORT",
"name": "flowlog-create-test"
}
]
}
GET /v2.0/flowlog-loggers/{flowlogLoggerId}
X-Auth-Token: {tokenId}
このAPIはリクエスト本文を要求しません。
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
flowlogLoggerId | URL | UUID | O | フローログロガーID |
Name | In | Type | Description |
---|---|---|---|
flowlog_logger | Body | Object | フローログロガー情報オブジェクト |
flowlog_logger.name | Body | String | フローログロガーの名前 |
flowlog_logger.resource_type | Body | String | フローログロガーの収集対象リソースタイプ。 VPC , SUBNET , PORT のいずれか |
flowlog_logger.resource_id | Body | UUID | フローログロガーの収集対象リソースID |
flowlog_logger.filter | Body | String | フローログロガーの収集対象フィルタ。 ALL , ACCEPT , DROP のいずれか* ACCEPT は通信が許可されたパケットのみをキャプチャ* DROP は通信がブロックされたパケットのみをキャプチャ* ALL は通信が許可・ブロックされたパケットをすべてキャプチャ |
flowlog_logger.aggregation_interval | Body | Integer | フローログロガーが収集したデータを合算・集計してストレージにファイルとして記録する周期。単位は分。ストレージにファイルが該当値を周期で作成される。 |
flowlog_logger.connection_setup_only | Body | Boolean | この値がtrue の場合、接続確立を試みたパケットのみを収集。true`に設定すると、以下のように収集対象が限定されます。* TCPの場合、TCP stateが確立されている場合は収集しない。 * UDP/ICMPの場合はレスポンスパケットを収集しない |
flowlog_logger.storage_type | Body | Boolean | フローログロガーのストレージタイプ。現在はOBS のみサポート。 |
flowlog_logger.storage_url | Body | Boolean | フローログロガーのストレージアドレス |
flowlog_logger.log_format | Body | Boolean | フローログロガーが保存するファイルのフォーマット。 CSV , PARQUET ファイル形式可能。 |
flowlog_logger.compression_type | Body | Boolean | フローログロガーが保存するファイルの圧縮形式。RAW , GZIP 圧縮形式可能。現在はRAW のみサポート。 |
flowlog_logger.customized_field | Body | String | フローログロガーがファイルに記録するフィールド。現在はサポートしない機能。 |
flowlog_logger.partition_period | Body | Boolean | フローログロガーがストレージにファイルを保存する際、フォルダ作成構造を意味する。HOUR とDAY をサポート。 * DAY を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY} フォルダを作成して日付を区切る* HOUR を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY}/{HOUR} までフォルダを作成して時間別に区切る |
flowlog_logger.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。 |
flowlog_logger.description | Body | Boolean | フローログロガーの説明 |
flowlog_logger.status | Body | Enum | フローログロガーの状態 |
flowlog_logger.created_at | Body | Date | フローログロガーを作成した時間 |
flowlog_logger.updated_at | Body | Date | フローログロガーが修正された時間 |
flowlog_logger.error_type | Body | String | フローログロガーにエラーが発生した場合、エラーの理由を表示。 詳細はページ下部のエラータイプをご確認ください。 |
{
"flowlog_logger": {
"status": "ACTIVE",
"connection_setup_only": false,
"description": "flowlog-create-description",
"partition_period": "HOUR",
"resource_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-08-04 05:22:57",
"error_type": "",
"updated_at": "2024-08-04 05:22:59",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"id": "8287f6df-42cb-4cb6-a3f3-0e13fad43526",
"filter": "ALL",
"storage_type": "OBS",
"aggregation_interval": 1,
"admin_state_up": true,
"log_format": "CSV",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"project_id": "419a823563124dc5b5627f5e79db8174",
"compression_type": "RAW",
"resource_type": "PORT",
"name": "flowlog-create-test"
}
}
string JP
POST /v2.0/flowlog-loggers
X-Auth-Token: {tokenId}
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
flowlog_logger | Body | Object | O | フローログロガー情報オブジェクト |
flowlog_logger.name | Body | String | O | フローログロガーの名前 |
flowlog_logger.resource_type | Body | String | フローログロガーの収集対象リソースタイプ。 VPC , SUBNET , PORT のいずれか。入力しない場合はPORT とみなす。 |
|
flowlog_logger.resource_id | Body | UUID | O | フローログロガーの収集対象リソースID |
flowlog_logger.filter | Body | String | フローログロガーの収集対象フィルタ。 ALL , ACCEPT , DROP のいずれかデフォルト値はALL 。* ACCEPT は通信が許可されたパケットのみをキャプチャ* DROP は通信がブロックされたパケットのみをキャプチャ* ALL は通信が許可・ブロックされたパケットをすべてキャプチャ |
|
flowlog_logger.aggregation_interval | Body | Integer | フローログロガーが収集したデータを合算・集計してストレージにファイルとして記録する周期。単位は分。ストレージにファイルが該当値を周期で作成される。デフォルト値は10分。 | |
flowlog_logger.connection_setup_only | Body | Boolean | この値がtrue の場合、接続確立を試みたパケットのみを収集。trueに設定すると、以下のように収集対象が限定されます。デフォルト値は false`* TCPの場合、TCP stateが確立されている場合は収集しない。 * UDP/ICMPの場合はレスポンスパケットを収集しない |
|
flowlog_logger.storage_type | Body | Boolean | O | フローログロガーのストレージタイプ。現在はOBS のみサポート。 |
flowlog_logger.storage_url | Body | Boolean | O | フローログロガーのストレージアドレス。ストレージタイプがOBS の場合はhttps://{object-storage-endpoint}/{AUTH-id}/{container}/{directory-path} をすべて入力する必要がある。 |
flowlog_logger.log_format | Body | Boolean | フローログロガーが保存するファイルのフォーマット。 CSV , PARQUET ファイル形式可能。デフォルト値はCSV 。 |
|
flowlog_logger.compression_type | Body | Boolean | フローログロガーが保存するファイルの圧縮形式。RAW , GZIP 圧縮形式可能。現在はRAW のみサポート。デフォルト値はRAW 。 |
|
flowlog_logger.customized_field | Body | String | フローログロガーがファイルに記録するフィールド | |
フローログロガーがストレージにファイルを保存する際、フォルダ作成構造を意味する。HOUR とDAY をサポート。デフォルト値はDAY 。* DAY を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY} フォルダを作成して日付を区切る* HOUR を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY}/{HOUR} までフォルダを作成して時間別に区切る |
||||
flowlog_logger.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。デフォルト値はtrue 。 |
|
flowlog_logger.description | Body | Boolean | フローログロガーの説明 |
{
"flowlog_logger": {
"name": "flowlog-create-test",
"resource_type": "PORT",
"resource_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"filter": "ALL",
"aggregation_interval": 1,
"connection_setup_only": false,
"storage_type": "OBS",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"log_format": "CSV",
"compression_type": "RAW",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"partition_period": "HOUR",
"admin_state_up": true,
"description": "KR2 alpha cloud trail test"
}
}
名前 | 種類 | 形式 | 説明 |
---|---|---|---|
flowlog_logger | Body | Object | フローログロガー情報オブジェクト |
flowlog_logger.name | Body | String | フローログロガーの名前 |
flowlog_logger.resource_type | Body | String | フローログロガーの収集対象リソースタイプ。 VPC , SUBNET , PORT のいずれか |
flowlog_logger.resource_id | Body | UUID | フローログロガーの収集対象リソースID |
flowlog_logger.filter | Body | String | フローログロガーの収集対象フィルタ。 ALL , ACCEPT , DROP のいずれか* ACCEPT は通信が許可されたパケットのみをキャプチャ* DROP は通信がブロックされたパケットのみをキャプチャ* ALL は通信が許可・ブロックされたパケットをすべてキャプチャ |
flowlog_logger.aggregation_interval | Body | Integer | フローログロガーが収集したデータを合算・集計してストレージにファイルとして記録する周期。単位は分。ストレージにファイルが該当値を周期で作成される。 |
flowlog_logger.connection_setup_only | Body | Boolean | この値がtrue の場合、接続確立を試みたパケットのみを収集。true`に設定すると、以下のように収集対象が限定されます。* TCPの場合、TCP stateが確立されている場合は収集しない。 * UDP/ICMPの場合はレスポンスパケットを収集しない |
flowlog_logger.storage_type | Body | Boolean | フローログロガーのストレージタイプ。現在はOBS のみサポート。 |
flowlog_logger.storage_url | Body | Boolean | フローログロガーのストレージアドレス |
flowlog_logger.log_format | Body | Boolean | フローログロガーが保存するファイルのフォーマット。 CSV , PARQUET ファイル形式可能。 |
flowlog_logger.compression_type | Body | Boolean | フローログロガーが保存するファイルの圧縮形式。RAW , GZIP 圧縮形式可能。現在はRAW のみサポート。 |
flowlog_logger.customized_field | Body | String | フローログロガーがファイルに記録するフィールド。現在はサポートしない機能。 |
flowlog_logger.partition_period | Body | Boolean | フローログロガーがストレージにファイルを保存する際、フォルダ作成構造を意味する。HOUR とDAY をサポート。 * DAY を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY} フォルダを作成して日付を区切る* HOUR を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY}/{HOUR} までフォルダを作成して時間別に区切る |
flowlog_logger.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。 |
flowlog_logger.description | Body | Boolean | フローログロガーの説明 |
flowlog_logger.status | Body | Enum | フローログロガーの状態 |
flowlog_logger.created_at | Body | Date | フローログロガーを作成した時間 |
flowlog_logger.updated_at | Body | Date | フローログロガーが修正された時間 |
flowlog_logger.error_type | Body | String | フローログロガーにエラーが発生した場合、エラー理由を表示。 詳細は、ページ下部をご確認ください。 |
{
"flowlog_logger": {
"status": "BUILD",
"connection_setup_only": false,
"description": "KR2 alpha cloud trail test",
"partition_period": "HOUR",
"resource_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-08-04 04:46:33",
"error_type": "",
"updated_at": "2024-08-04 04:46:33",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"id": "08288f3c-d535-4343-9998-8d1d76a5c8a1",
"filter": "ALL",
"storage_type": "OBS",
"aggregation_interval": 1,
"admin_state_up": true,
"log_format": "CSV",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"project_id": "419a823563124dc5b5627f5e79db8174",
"compression_type": "RAW",
"resource_type": "PORT",
"name": "flowlog-create-test"
}
}
string JP
PUT /v2.0/flowlog-loggers/{flowlogLoggerId}
X-Auth-Token: {tokenId}
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
flowlogLoggerId | URL | UUID | O | フローログロガーID |
flowlog_logger | Body | Object | O | フローログロガー情報オブジェクト |
flowlog_logger.name | Body | String | O | フローログロガーの名前 |
flowlog_logger.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。デフォルト値はtrue 。 |
|
flowlog_logger.description | Body | Boolean | フローログロガーの説明 |
{
"flowlog_logger": {
"name": "flowlog-name-updated",
"description": "flowlog-description-updated",
"admin_state_up": false
}
}
名前 | 種類 | 形式 | 説明 |
---|---|---|---|
flowlog_logger | Body | Object | フローログロガー情報オブジェクト |
flowlog_logger.name | Body | String | フローログロガーの名前 |
flowlog_logger.resource_type | Body | String | フローログロガーの収集対象リソースタイプ。 VPC , SUBNET , PORT のいずれか |
flowlog_logger.resource_id | Body | UUID | フローログロガーの収集対象リソースID |
flowlog_logger.filter | Body | String | フローログロガーの収集対象フィルタ。 ALL , ACCEPT , DROP のいずれか* ACCEPT は通信が許可されたパケットのみをキャプチャ* DROP は通信がブロックされたパケットのみをキャプチャ* ALL は通信が許可・ブロックされたパケットをすべてキャプチャ |
flowlog_logger.aggregation_interval | Body | Integer | フローログロガーが収集したデータを合算・集計してストレージにファイルとして記録する周期。単位は分。ストレージにファイルが該当値を周期で作成される。 |
flowlog_logger.connection_setup_only | Body | Boolean | この値がtrue の場合、接続確立を試みたパケットのみを収集。true`に設定すると、以下のように収集対象が限定されます。* TCPの場合、TCP stateが確立されている場合は収集しない。 * UDP/ICMPの場合はレスポンスパケットを収集しない |
flowlog_logger.storage_type | Body | Boolean | フローログロガーのストレージタイプ。現在はOBS のみサポート。 |
flowlog_logger.storage_url | Body | Boolean | フローログロガーのストレージアドレス |
flowlog_logger.log_format | Body | Boolean | フローログロガーが保存するファイルのフォーマット。 CSV , PARQUET ファイル形式可能。 |
flowlog_logger.compression_type | Body | Boolean | フローログロガーが保存するファイルの圧縮形式。RAW , GZIP 圧縮形式可能。現在はRAW のみサポート。 |
flowlog_logger.customized_field | Body | String | フローログロガーがファイルに記録するフィールド。現在はサポートしない機能。 |
flowlog_logger.partition_period | Body | Boolean | フローログロガーがストレージにファイルを保存する際、フォルダ作成構造を意味する。HOUR とDAY をサポート。 * DAY を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY} フォルダを作成して日付を区切る* HOUR を指定すると、ユーザーが入力したstorage_urlのdirectory-pathの下に{YEAR}/{MONTH}/{DAY}/{HOUR} までフォルダを作成して時間別に区切る |
flowlog_logger.admin_state_up | Body | Boolean | フローログロガーの有効化状態。 false の場合、無効になり収集しない。 |
flowlog_logger.description | Body | Boolean | フローログロガーの説明 |
flowlog_logger.status | Body | Enum | フローログロガーの状態 |
flowlog_logger.created_at | Body | Date | フローログロガーを作成した時間 |
flowlog_logger.updated_at | Body | Date | フローログロガーが修正された時間 |
flowlog_logger.error_type | Body | String | フローログロガーにエラーが発生した場合、エラー理由を表示。 詳細は、ページ下部をご確認ください。 |
{
"flowlog_logger": {
"status": "INACTIVE",
"connection_setup_only": false,
"description": "flowlog-description-updated",
"partition_period": "HOUR",
"resource_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-08-04 05:22:57",
"error_type": "",
"updated_at": "2024-08-04 05:27:35.226363",
"customized_field": "timestamp_start,timestamp_end,interface_id,vm_id,subnet_id,vpc_id,region,protocol,src_addr,dst_addr,src_port,dst_port,tcp_flag,packets,bytes,filter,status",
"id": "8287f6df-42cb-4cb6-a3f3-0e13fad43526",
"filter": "ALL",
"storage_type": "OBS",
"aggregation_interval": 1,
"admin_state_up": false,
"log_format": "CSV",
"storage_url": "https://kr2-api-object-storage.alpha-nhncloudservice.com/v1/AUTH_e670167936434f85a03694184000ffe6/flowlog-test/240729",
"project_id": "419a823563124dc5b5627f5e79db8174",
"compression_type": "RAW",
"resource_type": "PORT",
"name": "flowlog-name-updated"
}
}
string JP
DELETE /v2.0/flowlog-loggers/{flowlogLoggerId}
X-Auth-Token: {tokenId}
このAPIはリクエスト本文を要求しません。
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
flowlogLoggerId | URL | UUID | O | フローログロガーID |
このAPIはレスポンス本文を返しません。
GET /v2.0/flowlog-logging-ports
X-Auth-Token: {tokenId}
このAPIはリクエスト本文を要求しません。
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
id | Query | UUID | - | 照会するフローログロギングポートのID |
logger_id | Query | UUID | - | 照会するフローログロギングポートのロガーID |
port_id | Query | UUID | - | 照会するフローログロギングポートのポートID |
network_id | Query | UUID | - | 照会するフローログのVPC ID |
名前 | 種類 | 形式 | 説明 |
---|---|---|---|
flowlog_logging_ports | Array | Object | フローログロギングオブジェクトの一覧 |
flowlog_logging_ports.id | Body | UUID | フローログロギングポートID |
flowlog_logging_ports.logger_id | Body | UUID | 該当フローログロギングポートが属するフローログロガーのID |
flowlog_logging_ports.port_id | Body | UUID | ロギングしているポートのID |
flowlog_logging_ports.network_id | Body | UUID | ネットワークID |
flowlog_logging_ports.created_at | Body | Date | フローログロギングポートが作成された時間 |
flowlog_logging_ports.updated_at | Body | Date | フローログロギングポートが修正された時間 |
{
"flowlog_logging_ports": [
{
"network_id": "0afbf332-3432-450f-a25a-3cfa56b886d9",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-07-29 09:21:09",
"updated_at": "2024-07-29 09:21:09",
"logger_id": "3e84619a-1e49-4b19-b353-a15f7d278f94",
"project_id": "419a823563124dc5b5627f5e79db8174",
"port_id": "12799b52-0c81-4820-8fe6-b4963989ffe1",
"id": "6e97b87a-21ac-42d2-afc7-6d180ba93417"
},
{
"network_id": "0afbf332-3432-450f-a25a-3cfa56b886d9",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-08-04 05:22:57",
"updated_at": "2024-08-04 05:22:57",
"logger_id": "8287f6df-42cb-4cb6-a3f3-0e13fad43526",
"project_id": "419a823563124dc5b5627f5e79db8174",
"port_id": "045e204c-4624-4b68-ac8a-7375989d3b79",
"id": "bb036e03-ce55-48d0-aea3-685bfbee24d0"
}
]
}
string JP
GET /v2.0/flowlog-logging-ports/{flowlogLoggingPortId}
X-Auth-Token: {tokenId}
このAPIはリクエスト本文を要求しません。
名前 | 種類 | 形式 | 必須 | 説明 |
---|---|---|---|---|
tokenId | Header | String | O | トークンID |
flowlogLoggingPortId | URL | UUID | O | フローログロギングポートID |
名前 | 種類 | 形式 | 説明 |
---|---|---|---|
flowlog_logging_port | Body | Object | フローログロギングオブジェクト |
flowlog_logging_port.id | Body | UUID | フローログロギングポートID |
flowlog_logging_port.logger_id | Body | UUID | 該当フローログロギングポートが属するフローログロガーのID |
flowlog_logging_port.port_id | Body | UUID | ロギングしているポートのID |
flowlog_logging_port.network_id | Body | UUID | ネットワークID |
flowlog_logging_port.created_at | Body | Date | フローログロギングポートが作成された時間 |
flowlog_logging_port.updated_at | Body | Date | フローログロギングポートが修正された時間 |
{
"flowlog_logging_port": {
"network_id": "0afbf332-3432-450f-a25a-3cfa56b886d9",
"tenant_id": "419a823563124dc5b5627f5e79db8174",
"created_at": "2024-07-29 09:21:09",
"updated_at": "2024-07-29 09:21:09",
"logger_id": "3e84619a-1e49-4b19-b353-a15f7d278f94",
"project_id": "419a823563124dc5b5627f5e79db8174",
"port_id": "12799b52-0c81-4820-8fe6-b4963989ffe1",
"id": "6e97b87a-21ac-42d2-afc7-6d180ba93417"
}
}
フローログを使う環境が正しく設定されていない場合、エラーが発生することがあります。この場合、flowlog_logger.error_typeを照会してエラーの原因を確認できます。
フローログロガーの状態とエラータイプは次のとおりです。
フローログロガー状態 | エラータイプ | エラー原因 | 確認必要事項 |
---|---|---|---|
ACTIVE | - | - | - |
BUILD | - | - | - |
ERROR | AuthenticationSystemError | 認証システムに問題があります。サポートにお問い合わせください。 | フローログシステムアカウントがKeystoneサーバーからトークン発行を受けられなかった場合です。 |
ERROR | OBSConfigurationError | OBS URL及びアクセスポリシーをご確認ください。 | ユーザーのストレージにダミーデータを送信したが、OBSアクセス権がないため403エラーが発生した場合です。コンテナURL及びアクセスポリシーをご確認ください。 |
ERROR | OBSServiceNotAvailableError | OBSサービスが動作しません。サポートにお問い合わせください。 | ユーザーのストレージにダミーデータを送信したが、401、403以外のエラーが発生した場合です。 |