REST Resource: projects.locations.vpcFlowLogsConfigs

Recurso: VpcFlowLogsConfig

Uma configuração para gerar registros 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 no nível do projeto: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

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

string

Opcional. Campos de metadados personalizados a serem incluídos nos registros de fluxo de VPC informados. Só poderá ser especificado se "metadata" estiver definido como CUSTOM_METADATA.
labels

map (key: string, value: string)

Opcional. Rótulos de recursos para representar metadados fornecidos por usuários

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

string (Timestamp format)

Apenas saída. O horário em que a configuração foi criada.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "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 a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "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 usuário da configuração dos Registros de fluxo de VPC. Use no máximo 512 caracteres.
state

enum (State)

Opcional. O estado da configuração de registros de fluxo de VPC. O valor padrão é ENABLED. Ao criar uma configuração, ela precisa ser ativada. Definir state=DISABLED vai pausar a geração de registros para essa configuração.
aggregationInterval

enum (AggregationInterval)

Opcional. O intervalo de agregação dos registros. O valor padrão é INTERVAL_5_SEC.
flowSampling

number

Opcional. O valor do campo precisa estar entre (0, 1]. A taxa de amostragem dos registros de fluxo de VPC, em que 1,0 significa que todos os registros coletados são reportados. Não é permitido definir a taxa de amostragem como 0,0. Se você quiser desativar os registros de fluxo da VPC, use o campo "state". O valor padrão é 1,0.
metadata

enum (Metadata)

Opcional. Configura se todos, nenhum ou um subconjunto de campos de metadados precisam ser adicionados aos registros de fluxo de VPC reportados. O valor padrão é INCLUDE_ALL_METADATA.
filterExpr

string

Opcional. Filtro de exportação usado para definir quais registros de fluxo de VPC precisam ser registrados.
crossProjectMetadata

enum (CrossProjectMetadata)

Opcional. Determina se as anotações entre projetos serão incluídas nos registros. Esse campo está disponível apenas para configurações da organização. Se não for especificado nas configurações da organização, será 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 escopo de configuração. Ou seja, o escopo de onde o tráfego é registrado. O recurso de destino precisa pertencer ao mesmo projeto que a configuração. Esse campo não é compatível com configurações no nível da organização. target_resource pode ser apenas de um dos tipos a seguir:
network

string

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

string

O tráfego será registrado das VMs na sub-rede. Formato: projects/{projectId}/regions/{region}/subnetworks/{name}
interconnectAttachment

string

O tráfego será registrado no anexo de interconexão. Formato: projects/{projectId}/regions/{region}/interconnectAttachments/{name}
vpnTunnel

string

O tráfego será registrado no túnel da VPN. Formato: projects/{projectId}/regions/{region}/vpnTunnels/{name}

Métodos

create

 Cria um VpcFlowLogsConfig novo.

delete

 Exclui um VpcFlowLogsConfig específico.

get

 Recebe os detalhes de um VpcFlowLogsConfig específico.

list

 Lista todos os VpcFlowLogsConfigs em um determinado projeto.

patch

 Atualiza um VpcFlowLogsConfig existente.

queryOrgVpcFlowLogsConfigs

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