REST Resource: projects.locations.vpcFlowLogsConfigs

Recurso: VpcFlowLogsConfig

Uma configuração para gerar registros de fluxos de 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 que devem ser incluídos nos registros de fluxos de VPC informados. Só pode 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)

Somente saída: a hora em que a operação foi criada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. 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 o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. 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 usuário da configuração dos registros de fluxos de VPC. Máximo de 512 caracteres.
state

enum (State)

Opcional. O estado da configuração dos registros de fluxos da 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 ficar 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 fluxos de VPC, use o campo "Estado". 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 fluxos de VPC reportados. O valor padrão é "INCLUDE_ALL_METADATA".
filterExpr

string

Opcional. Filtro de exportação usado para definir quais registros de fluxos 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 de interconexão da rede. Formato: projects/{projectId}/global/networks/{name}
subnet

string

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

string

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

string

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

Métodos

create

 Cria um novo VpcFlowLogsConfig.

delete

 Exclui um VpcFlowLogsConfig específico.

get

 Recebe os detalhes de um VpcFlowLogsConfig específico.

list

 Lista todas as VpcFlowLogsConfigs em um determinado projeto.

patch

 Atualiza um VpcFlowLogsConfig atual.

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.

showEffectiveFlowLogsConfigs

 ShowEffectiveFlowLogsConfigs retorna uma lista de todas as configurações de registros de fluxo de VPC aplicáveis a um recurso especificado.