Method: projects.locations.vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs

vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs는 지정된 리소스에 적용되는 모든 VPC 흐름 로그 구성 목록을 반환합니다.

HTTP 요청

GET https://networkmanagement.googleapis.com/v1/{parent=projects/*/locations/*}/vpcFlowLogsConfigs:showEffectiveFlowLogsConfigs

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목. VpcFlowLogsConfig의 상위 리소스입니다. 다음 형식으로 지정됩니다. projects/{projectId}/locations/global

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • networkmanagement.vpcflowlogsconfigs.list

쿼리 매개변수

매개변수
resource

string

필수 항목입니다. 유효한 VPC 흐름 로그 구성을 가져올 리소스입니다. 리소스는 상위 항목과 동일한 프로젝트에 속해야 합니다. 리소스는 네트워크, 서브네트워크, 상호 연결 연결, VPN 터널 또는 프로젝트여야 합니다.
pageSize

integer

(선택사항) 반환할 EffectiveVpcFlowLogsConfigs의 수 기본값은 30입니다.
pageToken

string

(선택사항) nextPageToken에 반환된 이전 쿼리의 페이지 토큰
filter

string

선택사항. 필터 표현식과 일치하는 EffectiveVpcFlowLogsConfigs를 나열합니다. 필터 표현식은 지원되는 CEL 논리 연산자를 사용해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs 메서드에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "effectiveFlowLogsConfigs": [
    {
      object (EffectiveVpcFlowLogsConfig)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
effectiveFlowLogsConfigs[]

object (EffectiveVpcFlowLogsConfig)

유효한 VPC 흐름 로그 구성 목록입니다.
nextPageToken

string

다음 구성 집합을 가져오는 페이지 토큰입니다.
unreachable[]

string

도달할 수없는 위치(-로 모든 위치를 쿼리할 때)

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

EffectiveVpcFlowLogsConfig

GetEffectiveVpcFlowLogsConfig 요청에 대한 응답을 생성하는 구성입니다.

JSON 표현 
{
  "name": string,
  "metadataFields": [
    string
  ],
  "state": enum (State),
  "aggregationInterval": enum (AggregationInterval),
  "flowSampling": number,
  "metadata": enum (Metadata),
  "filterExpr": string,
  "crossProjectMetadata": enum (CrossProjectMetadata),

  // 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.
  "scope": enum (Scope)
}
필드
name

string

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

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

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

  • 컴퓨트 구성의 경우 이름은 서브넷의 경로입니다(projects/{projectId}/regions/{region}/subnetworks/{subnet_id}).
metadataFields[]

string

보고된 VPC 흐름 로그에 포함할 커스텀 메타데이터 필드입니다. 'metadata'가 CUSTOM_METADATA로 설정된 경우에만 지정할 수 있습니다.
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로 설정됩니다.
통합 필드 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}
scope

enum (Scope)

구성의 범위를 지정합니다 (예: SUBNET, NETWORK, ORGANIZATION 등)을 사용합니다.

범위

이 흐름 로그 구성의 범위입니다.

열거형
SCOPE_UNSPECIFIED 범위가 지정되지 않았습니다.
SUBNET 타겟 리소스가 서브넷 (네트워크 관리 API)입니다.
COMPUTE_API_SUBNET 타겟 리소스가 서브넷이고 구성이 Compute API에서 시작됩니다.
NETWORK 타겟 리소스가 네트워크입니다.
VPN_TUNNEL 타겟 리소스가 VPN 터널입니다.
INTERCONNECT_ATTACHMENT 타겟 리소스는 인터커넥트 연결입니다.
ORGANIZATION 구성은 조직 전체에 적용됩니다.