Method: projects.locations.vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs

vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs restituisce un elenco di tutte le configurazioni dei log di flusso VPC applicabili a una risorsa specificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La risorsa padre di VpcFlowLogsConfig, specificata nel seguente formato: projects/{projectId}/locations/global

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata parent:

  • networkmanagement.vpcflowlogsconfigs.list

Parametri di query

Parametri
resource

string

Obbligatorio. La risorsa per cui ottenere la configurazione effettiva dei log di flusso VPC. La risorsa deve appartenere allo stesso progetto del padre. La risorsa deve essere una rete, una subnet, un collegamento di interconnessione, un tunnel VPN o un progetto.
pageSize

integer

Facoltativo. Numero di EffectiveVpcFlowLogsConfigs da restituire. Il valore predefinito è 30.
pageToken

string

Facoltativo. Token di pagina di una query precedente, restituito in nextPageToken.
filter

string

Facoltativo. Elenca i EffectiveVpcFlowLogsConfigs che corrispondono all'espressione di filtro. Un'espressione di filtro deve utilizzare gli operatori logici CEL supportati.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per il metodo vpcFlowLogsConfigs.showEffectiveFlowLogsConfigs.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

object (EffectiveVpcFlowLogsConfig)

Elenco delle configurazioni dei log di flusso VPC effettive.
nextPageToken

string

Token di pagina per recuperare il gruppo successivo di configurazioni.
unreachable[]

string

Località che non è stato possibile raggiungere (quando si esegue una query su tutte le località con -).

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta Authentication Overview.

EffectiveVpcFlowLogsConfig

Una configurazione per generare una risposta per la richiesta GetEffectiveVpcFlowLogsConfig.

Rappresentazione 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)
}
Campi
name

string

Nome univoco della configurazione. Il nome può avere uno dei seguenti formati:

  • Per le configurazioni a livello di progetto: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • Per le configurazioni a livello di organizzazione: organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • Per una configurazione di Compute, il nome sarà il percorso della subnet: projects/{projectId}/regions/{region}/subnetworks/{subnet_id}
metadataFields[]

string

Campi di metadati personalizzati da includere nei log di flusso VPC segnalati. Può essere specificato solo se "metadata" è stato impostato su CUSTOM_METADATA.
state

enum (State)

Lo stato della configurazione dei log di flusso VPC. Il valore predefinito è ENABLED. Quando crei una nuova configurazione, questa deve essere attivata. Se imposti state=DISABLED, la generazione dei log per questa configurazione verrà sospesa.
aggregationInterval

enum (AggregationInterval)

L'intervallo di aggregazione per i log. Il valore predefinito è INTERVAL_5_SEC.
flowSampling

number

Il valore del campo deve essere compreso tra 0 e 1. La frequenza di campionamento dei log di flusso VPC, dove 1.0 indica che vengono segnalati tutti i log raccolti. Non è consentito impostare la frequenza di campionamento su 0,0. Se vuoi disattivare i log di flusso VPC, utilizza invece il campo state. Il valore predefinito è 1.0.
metadata

enum (Metadata)

Configura se tutti, nessuno o un sottoinsieme di campi di metadati devono essere aggiunti ai log di flusso VPC segnalati. Il valore predefinito è INCLUDE_ALL_METADATA.
filterExpr

string

Filtro di esportazione utilizzato per definire quali log di flusso VPC devono essere registrati.
crossProjectMetadata

enum (CrossProjectMetadata)

Determina se includere le annotazioni tra progetti nei log. Questo campo è disponibile solo per le configurazioni dell'organizzazione. Se non specificato nelle configurazioni dell'organizzazione, verrà impostato su CROSS_PROJECT_METADATA_ENABLED.
Campo unione target_resource. Riferimento alla risorsa dell'ambito di configurazione. ovvero l'ambito da cui viene registrato il traffico. La risorsa di destinazione deve appartenere allo stesso progetto della configurazione. Questo campo non è supportato per le configurazioni a livello di organizzazione. target_resource può essere solo uno dei seguenti:
network

string

Il traffico verrà registrato da VM, tunnel VPN e collegamenti di interconnessione all'interno della rete. Formato: projects/{projectId}/global/networks/{name}
subnet

string

Il traffico verrà registrato dalle VM all'interno della subnet. Formato: projects/{projectId}/regions/{region}/subnetworks/{name}
interconnectAttachment

string

Il traffico verrà registrato dall'allegato di interconnessione. Formato: projects/{projectId}/regions/{region}/interconnectAttachments/{name}
vpnTunnel

string

Il traffico verrà registrato dal tunnel VPN. Formato: projects/{projectId}/regions/{region}/vpnTunnels/{name}
scope

enum (Scope)

Specifica l'ambito della configurazione (ad es. SUBNET, NETWORK, ORGANIZATION..).

Ambito

L'ambito di questa configurazione dei log di flusso.

Enum
SCOPE_UNSPECIFIED L'ambito non è specificato.
SUBNET La risorsa di destinazione è una subnet (API Network Management).
COMPUTE_API_SUBNET La risorsa di destinazione è una subnet e la configurazione ha origine dall'API Compute.
NETWORK La risorsa di destinazione è una rete.
VPN_TUNNEL La risorsa di destinazione è un tunnel VPN.
INTERCONNECT_ATTACHMENT La risorsa di destinazione è un collegamento di interconnessione.
ORGANIZATION La configurazione si applica a un'intera organizzazione.