REST Resource: projects.locations.vpcFlowLogsConfigs

Recurso: VpcFlowLogsConfig

Uma configuração para gerar registos de fluxo da VPC.

Representação 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.
}
Campos
name

string

Identificador. Nome exclusivo da configuração. O nome pode ter uma das seguintes formas:

  • Para configurações ao nível do projeto: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

  • Para configurações ao nível da organização: organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}
metadataFields[]

string

Opcional. Campos de metadados personalizados a incluir nos registos de fluxo de VPC comunicados. Só pode ser especificado se "metadata" tiver sido definido como CUSTOM_METADATA.
labels

map (key: string, value: string)

Opcional. Etiquetas de recursos para representar metadados fornecidos pelos utilizadores.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Apenas saída. A hora em que a configuração foi criada.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A hora em que a configuração foi atualizada.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
description

string

Opcional. A descrição fornecida pelo utilizador da configuração dos registos de fluxo da VPC. Um máximo de 512 carateres.
state

enum (State)

Opcional. O estado da configuração do VPC Flow Logs. O valor predefinido é ENABLED. Quando cria uma nova configuração, esta tem de ser ativada. A definição state=DISABLED pausa a geração de registos para esta configuração.
aggregationInterval

enum (AggregationInterval)

Opcional. O intervalo de agregação para os registos. O valor predefinido é INTERVAL_5_SEC.
flowSampling

number

Opcional. O valor do campo tem de estar em (0, 1]. A taxa de amostragem dos registos de fluxo de VPC, em que 1,0 significa que todos os registos recolhidos são comunicados. Não é permitido definir a taxa de amostragem como 0,0. Se quiser desativar os registos de fluxo de VPC, use o campo de estado. O valor predefinido é 1,0.
metadata

enum (Metadata)

Opcional. Configura se todos, nenhum ou um subconjunto de campos de metadados devem ser adicionados aos registos de fluxo de VPC comunicados. O valor predefinido é INCLUDE_ALL_METADATA.
filterExpr

string

Opcional. Filtro de exportação usado para definir que VPC Flow Logs devem ser registados.
crossProjectMetadata

enum (CrossProjectMetadata)

Opcional. Determina se devem ser incluídas anotações entre projetos nos registos. Este campo só está disponível para configurações de organização. Se não for especificado nas configurações da organização, é definido como CROSS_PROJECT_METADATA_ENABLED.
targetResourceState

enum (TargetResourceState)

Apenas saída. Descreve o estado do recurso de destino configurado para fins de diagnóstico.
Campo de união target_resource. Referência ao recurso do âmbito de configuração. Ou seja, o âmbito a partir do qual o tráfego é registado. O recurso de destino tem de pertencer ao mesmo projeto que a configuração. Este campo não é suportado para configurações ao nível da organização. target_resource só pode ser uma das seguintes opções:
network

string

O tráfego é registado a partir de VMs, túneis VPN e anexos do Interconnect na rede. Formato: projects/{projectId}/global/networks/{name}
subnet

string

O tráfego é registado a partir de VMs na sub-rede. Formato: projects/{projectId}/regions/{region}/subnetworks/{name}
interconnectAttachment

string

O tráfego é registado a partir da associação do Interconnect. Formato: projects/{projectId}/regions/{region}/interconnectAttachments/{name}
vpnTunnel

string

O tráfego é registado a partir do túnel VPN. Formato: projects/{projectId}/regions/{region}/vpnTunnels/{name}

Métodos

create

 Cria um novo VpcFlowLogsConfig.

delete

 Elimina um VpcFlowLogsConfig específico.

get

 Obtém os detalhes de um VpcFlowLogsConfig específico.

list

 Apresenta todos os VpcFlowLogsConfigs num determinado projeto.

patch

 Atualiza um VpcFlowLogsConfig existente.

queryOrgVpcFlowLogsConfigs

 QueryOrgVpcFlowLogsConfigs devolve uma lista de todas as configurações de registos de fluxo de VPC ao nível da organização aplicáveis ao projeto especificado.