Method: projects.locations.vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs

vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs menampilkan daftar semua konfigurasi VPC Flow Logs yang berlaku untuk resource tertentu.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk VpcFlowLogsConfig, yang ditentukan dalam format berikut: projects/{projectId}/locations/global

Otorisasi memerlukan izin IAM berikut pada resource yang ditentukan parent:

  • networkmanagement.vpcflowlogsconfigs.list

Parameter kueri

Parameter
resource

string

Wajib. Resource untuk mendapatkan konfigurasi Log Aliran VPC yang efektif. Resource harus termasuk dalam project yang sama dengan induk. Resource harus berupa jaringan, subnetwork, lampiran interconnect, tunnel VPN, atau project.

pageSize

integer

Opsional. Jumlah EffectiveVpcFlowLogsConfigs yang akan ditampilkan. Defaultnya adalah 30.

pageToken

string

Opsional. Token halaman dari kueri sebelumnya, seperti yang ditampilkan di nextPageToken.

filter

string

Opsional. Mencantumkan EffectiveVpcFlowLogsConfigs yang cocok dengan ekspresi filter. Ekspresi filter harus menggunakan operator logika CEL yang didukung.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk metode vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "effectiveFlowLogsConfigs": [
    {
      object (EffectiveVpcFlowLogsConfig)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Kolom
effectiveFlowLogsConfigs[]

object (EffectiveVpcFlowLogsConfig)

Daftar konfigurasi Log Aliran VPC yang Efektif.

nextPageToken

string

Token halaman untuk mengambil set konfigurasi berikutnya.

unreachable[]

string

Lokasi yang tidak dapat dijangkau (saat mengkueri semua lokasi dengan -).

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

EffectiveVpcFlowLogsConfig

Konfigurasi untuk membuat respons untuk permintaan GetEffectiveVpcFlowLogsConfig.

Representasi 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)
}
Kolom
name

string

Nama unik konfigurasi. Nama dapat memiliki salah satu bentuk berikut:

  • Untuk konfigurasi tingkat project: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • Untuk konfigurasi tingkat organisasi: organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • Untuk konfigurasi Compute, namanya adalah jalur subnet: projects/{projectId}/regions/{region}/subnetworks/{subnet_id}

metadataFields[]

string

Kolom metadata kustom yang akan disertakan dalam log aliran VPC yang dilaporkan. Hanya dapat ditentukan jika "metadata" disetel ke CUSTOM_METADATA.

state

enum (State)

Status konfigurasi Log Aliran VPC. Nilai defaultnya adalah ENABLED. Saat membuat konfigurasi baru, konfigurasi tersebut harus diaktifkan. Menetapkan state=DISABLED akan menjeda pembuatan log untuk konfigurasi ini.

aggregationInterval

enum (AggregationInterval)

Interval agregasi untuk log. Nilai defaultnya adalah INTERVAL_5_SEC.

flowSampling

number

Nilai kolom harus dalam (0, 1]. Frekuensi pengambilan sampel Log Aliran VPC, dengan 1,0 berarti semua log yang dikumpulkan dilaporkan. Menetapkan rasio pengambilan sampel ke 0,0 tidak diizinkan. Jika Anda ingin menonaktifkan Log Aliran VPC, gunakan kolom status. Nilai defaultnya adalah 1,0.

metadata

enum (Metadata)

Mengonfigurasi apakah semua, tidak ada, atau sebagian kolom metadata harus ditambahkan ke log aliran VPC yang dilaporkan. Nilai defaultnya adalah INCLUDE_ALL_METADATA.

filterExpr

string

Filter ekspor yang digunakan untuk menentukan Log Aliran VPC mana yang harus dicatat.

crossProjectMetadata

enum (CrossProjectMetadata)

Menentukan apakah akan menyertakan anotasi lintas project dalam log. Kolom ini hanya tersedia untuk konfigurasi organisasi. Jika tidak ditentukan dalam konfigurasi organisasi, akan ditetapkan ke CROSS_PROJECT_METADATA_ENABLED.

Kolom union target_resource. Referensi ke resource cakupan konfigurasi. Artinya, cakupan tempat traffic dicatat. Resource target harus termasuk dalam project yang sama dengan konfigurasi. Kolom ini tidak didukung untuk konfigurasi tingkat organisasi. target_resource hanya ada berupa salah satu diantara berikut:
network

string

Traffic akan dicatat dari VM, tunnel VPN, dan Lampiran Interconnect dalam jaringan. Format: projects/{projectId}/global/networks/{name}

subnet

string

Traffic akan dicatat dari VM dalam subnetwork. Format: projects/{projectId}/regions/{region}/subnetworks/{name}

interconnectAttachment

string

Traffic akan dicatat dari Lampiran Interconnect. Format: projects/{projectId}/regions/{region}/interconnectAttachments/{name}

vpnTunnel

string

Traffic akan dicatat dari Tunnel VPN. Format: projects/{projectId}/regions/{region}/vpnTunnels/{name}

scope

enum (Scope)

Menentukan cakupan konfigurasi (misalnya, SUBNET, NETWORK, ORGANIZATION..).

Cakupan

Cakupan untuk konfigurasi log alur ini.

Enum
SCOPE_UNSPECIFIED Cakupan tidak ditentukan.
SUBNET Resource target adalah subnet (Network Management API).
COMPUTE_API_SUBNET Resource target adalah subnet, dan konfigurasi berasal dari Compute API.
NETWORK Resource target adalah jaringan.
VPN_TUNNEL Resource target adalah tunnel VPN.
INTERCONNECT_ATTACHMENT Target resource adalah lampiran interkoneksi.
ORGANIZATION Konfigurasi berlaku untuk seluruh organisasi.