REST Resource: projects.locations.vpcFlowLogsConfigs

Recurso: VpcFlowLogsConfig

Una configuración para generar registros de flujo de VPC.

Representación 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,

  // Union field target_resource can be only one of the following:
  "interconnectAttachment": string,
  "vpnTunnel": string
  // End of list of possible types for union field target_resource.
}
Campos
name

string

Identificador. Nombre único de la configuración con el formato: projects/{projectId}/locations/global/vpcFlowLogsConfigs/{vpcFlowLogsConfigId}

metadataFields[]

string

Opcional. Campos de metadatos personalizados para incluir en los registros de flujo de VPC informados. Solo se puede especificar si "metadata" se estableció en CUSTOM_METADATA.

labels

map (key: string, value: string)

Opcional. Son las etiquetas de los recursos para representar los metadatos proporcionados por el usuario.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

Solo salida. Es la hora en que se creó la configuración.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. La hora a la que se actualizó la configuración.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

description

string

Opcional. Descripción de la configuración de registros de flujo de VPC proporcionada por el usuario. Puede tener un máximo de 512 caracteres

state

enum (State)

Opcional. Es el estado de la configuración de los registros de flujo de VPC. El valor predeterminado es HABILITADO. Cuando se crea una configuración nueva, debe estar habilitada.

aggregationInterval

enum (AggregationInterval)

Opcional. Es el intervalo de agregación de los registros. El valor predeterminado es INTERVAL_5_SEC.

flowSampling

number

Opcional. El valor del campo debe estar en (0, 1]. La tasa de muestreo de los registros de flujo de VPC, en la que 1.0 significa que se informan todos los registros recopilados. No se permite establecer la tasa de muestreo en 0.0. Si quieres inhabilitar los registros de flujo de VPC, usa el campo de estado. El valor predeterminado es 1.0.

metadata

enum (Metadata)

Opcional. Configura si se deben agregar todos, ninguno o un subconjunto de campos de metadatos a los registros de flujo de VPC informados. El valor predeterminado es INCLUDE_ALL_METADATA.

filterExpr

string

Opcional. Es el filtro de exportación que se usa para definir qué registros de flujo de VPC se deben registrar.

Campo de unión target_resource. Es la referencia al recurso del permiso de configuración. Es decir, el alcance desde el que se registra el tráfico. El recurso de destino debe pertenecer al mismo proyecto que la configuración. target_resource puede ser solo uno de los siguientes:
interconnectAttachment

string

El tráfico se registrará desde el adjunto de interconexión. Formato: projects/{projectId}/regions/{region}/interconnectAttachments/{name}

vpnTunnel

string

El tráfico se registrará desde el túnel VPN. Formato: projects/{projectId}/regions/{region}/vpnTunnels/{name}

Estado

Determina si esta configuración generará registros. Si estableces state=DISABLED, se pausará la generación de registros para esta configuración.

Enums
STATE_UNSPECIFIED Si no se especifica, se establecerá de forma predeterminada como HABILITADO.
ENABLED Cuando está HABILITADA, esta configuración generará registros.
DISABLED Cuando está INHABILITADA, esta configuración no generará registros.

AggregationInterval

Activa o desactiva el intervalo de agregación para recopilar registros de flujo por 5 tuplas.

Enums
AGGREGATION_INTERVAL_UNSPECIFIED Si no se especifica, se establecerá de forma predeterminada en INTERVAL_5_SEC.
INTERVAL_5_SEC Agrega registros en intervalos de 5 s.
INTERVAL_30_SEC Agrega registros en intervalos de 30 s.
INTERVAL_1_MIN Agrupa los registros en intervalos de 1 min.
INTERVAL_5_MIN Agrega registros en intervalos de 5 min.
INTERVAL_10_MIN Agrega registros en intervalos de 10 min.
INTERVAL_15_MIN Agrega registros en intervalos de 15 min.

Metadatos

Configura qué campos de registro se incluirán.

Enums
METADATA_UNSPECIFIED Si no se especifica, se establecerá de forma predeterminada como INCLUDE_ALL_METADATA.
INCLUDE_ALL_METADATA Incluye todos los campos de metadatos.
EXCLUDE_ALL_METADATA Excluye todos los campos de metadatos.
CUSTOM_METADATA Incluye solo campos personalizados (especificados en metadataFields).

Métodos

create

Crea una VpcFlowLogsConfig nueva.

delete

Elimina una VpcFlowLogsConfig específica.

get

Obtiene los detalles de un VpcFlowLogsConfig específico.

list

Enumera todos los VpcFlowLogsConfigs en un proyecto determinado.

patch

Actualiza un VpcFlowLogsConfig existente.