REST Resource: organizations.locations.vpcFlowLogsConfigs

리소스: VpcFlowLogsConfig

VPC 흐름 로그를 생성하기 위한 구성입니다.

JSON 표현 
{
  "name": string,
  "metadataFields": [
    string
  ],
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "description": string,
  "state": enum (State),
  "aggregationInterval": enum (AggregationInterval),
  "flowSampling": number,
  "metadata": enum (Metadata),
  "filterExpr": string,
  "crossProjectMetadata": enum (CrossProjectMetadata),
  "targetResourceState": enum (TargetResourceState),

  // Union field target_resource can be only one of the following:
  "network": string,
  "subnet": string,
  "interconnectAttachment": string,
  "vpnTunnel": string
  // End of list of possible types for union field target_resource.
}
필드
name

string

식별자. 구성의 고유한 이름입니다. 이름은 다음 형식 중 하나일 수 있습니다.

  • 프로젝트 수준 구성의 경우: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • 조직 수준 구성의 경우: organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}
metadataFields[]

string

선택사항입니다. 보고된 VPC 흐름 로그에 포함할 커스텀 메타데이터 필드입니다. 'metadata'가 CUSTOM_METADATA로 설정된 경우에만 지정할 수 있습니다.
labels

map (key: string, value: string)

선택사항입니다. 사용자가 제공한 메타데이터를 나타내는 리소스 라벨입니다.

"key": value 쌍 목록이 포함된 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
createTime

string (Timestamp format)

출력 전용입니다. 구성이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 구성이 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
description

string

선택사항입니다. VPC 흐름 로그 구성에 대해 사용자가 제공한 설명입니다. 영문 기준 최대 152자.
state

enum (State)

선택사항입니다. VPC 흐름 로그 구성의 상태입니다. 기본값은 ENABLED입니다. 새 구성을 만들 때는 사용 설정해야 합니다. state=DISABLED를 설정하면 이 구성의 로그 생성이 일시중지됩니다.
aggregationInterval

enum (AggregationInterval)

선택사항입니다. 로그의 집계 간격입니다. 기본값은 INTERVAL_5_SEC입니다.
flowSampling

number

선택사항입니다. 필드 값이 [0, 1] 내에 있어야 합니다. VPC 흐름 로그의 샘플링 레이트로, 여기서 1.0은 수집된 모든 로그가 보고됨을 의미합니다. 샘플링 레이트를 0.0으로 설정하는 것은 허용되지 않습니다. VPC 흐름 로그를 사용 중지하려면 대신 상태 필드를 사용하세요. 기본값은 1.0입니다.
metadata

enum (Metadata)

선택사항입니다. 보고된 VPC 흐름 로그에 메타데이터 필드를 모두 추가할지, 아무것도 추가하지 않을지, 일부만 추가할지 구성합니다. 기본값은 INCLUDE_ALL_METADATA입니다.
filterExpr

string

선택사항입니다. 로깅해야 하는 VPC 흐름 로그를 정의하는 데 사용되는 내보내기 필터입니다.
crossProjectMetadata

enum (CrossProjectMetadata)

선택사항입니다. 로그에 교차 프로젝트 주석을 포함할지 여부를 결정합니다. 이 필드는 조직 구성에만 사용할 수 있습니다. 조직 구성에 지정되지 않은 경우 CROSS_PROJECT_METADATA_ENABLED로 설정됩니다.
targetResourceState

enum (TargetResourceState)

출력 전용입니다. 진단 목적으로 구성된 대상 리소스의 상태를 설명합니다.
통합 필드 target_resource. 구성 범위의 리소스에 대한 참조입니다. 즉, 트래픽이 로깅되는 범위입니다. 대상 리소스는 구성과 동일한 프로젝트에 속해야 합니다. 이 필드는 조직 수준 구성에서 지원되지 않습니다. target_resource는 다음 중 하나여야 합니다.
network

string

트래픽이 네트워크 내의 VM, VPN 터널, Interconnect 연결에서 로깅됩니다. 형식: projects/{projectId}/global/networks/{name}
subnet

string

트래픽이 서브네트워크 내 VM에서 로깅됩니다. 형식: projects/{projectId}/regions/{region}/subnetworks/{name}
interconnectAttachment

string

트래픽이 Interconnect 연결에서 로깅됩니다. 형식: projects/{projectId}/regions/{region}/interconnectAttachments/{name}
vpnTunnel

string

트래픽이 VPN 터널에서 로깅됩니다. 형식: projects/{projectId}/regions/{region}/vpnTunnels/{name}

상태

이 구성에서 로그를 생성할지 여부를 결정합니다.

열거형
STATE_UNSPECIFIED 지정하지 않으면 ENABLED로 기본 설정됩니다.
ENABLED ENABLED로 설정하면 이 구성에서 로그가 생성됩니다.
DISABLED DISABLED로 설정하면 이 구성에서 로그를 생성하지 않습니다.

AggregationInterval

5튜플로 흐름 로그를 수집하기 위한 집계 간격을 전환합니다.

열거형
AGGREGATION_INTERVAL_UNSPECIFIED 지정하지 않으면 INTERVAL_5_SEC로 기본 설정됩니다.
INTERVAL_5_SEC 5초 간격으로 로그를 집계합니다.
INTERVAL_30_SEC 30초 간격으로 로그를 집계합니다.
INTERVAL_1_MIN 1분 간격으로 로그를 집계합니다.
INTERVAL_5_MIN 5분 간격으로 로그를 집계합니다.
INTERVAL_10_MIN 10분 간격으로 로그를 집계합니다.
INTERVAL_15_MIN 15분 간격으로 로그를 집계합니다.

메타데이터

포함할 로그 필드를 구성합니다.

열거형
METADATA_UNSPECIFIED 지정하지 않으면 INCLUDE_ALL_METADATA로 기본 설정됩니다.
INCLUDE_ALL_METADATA 모든 메타데이터 필드를 포함합니다.
EXCLUDE_ALL_METADATA 모든 메타데이터 필드를 제외합니다.
CUSTOM_METADATA 커스텀 필드만 포함합니다(metadataFields에 지정됨).

CrossProjectMetadata

로그에 교차 프로젝트 주석을 포함할지 여부를 결정합니다. 프로젝트 구성에는 항상 CROSS_PROJECT_METADATA_DISABLED가 있습니다.

열거형
CROSS_PROJECT_METADATA_UNSPECIFIED 지정하지 않으면 기본값은 CROSS_PROJECT_METADATA_ENABLED입니다.
CROSS_PROJECT_METADATA_ENABLED CROSS_PROJECT_METADATA_ENABLED인 경우 다른 프로젝트의 메타데이터가 로그에 포함됩니다.
CROSS_PROJECT_METADATA_DISABLED CROSS_PROJECT_METADATA_DISABLED인 경우 다른 프로젝트의 메타데이터가 로그에 포함되지 않습니다.

TargetResourceState

출력 전용입니다. 진단 목적으로 대상 리소스가 있는지 여부를 나타냅니다.

열거형
TARGET_RESOURCE_STATE_UNSPECIFIED 지정되지 않은 대상 리소스 상태입니다.
TARGET_RESOURCE_EXISTS 대상 리소스가 있음을 나타냅니다.
TARGET_RESOURCE_DOES_NOT_EXIST 대상 리소스가 없음을 나타냅니다.

메서드

create

 새 VpcFlowLogsConfig를 만듭니다.

delete

 특정 VpcFlowLogsConfig를 삭제합니다.

get

 특정 VpcFlowLogsConfig의 세부정보를 가져옵니다.

list

 특정 조직의 모든 VpcFlowLogsConfigs를 나열합니다.

patch

 기존 VpcFlowLogsConfig를 업데이트합니다.