gcloud beta network-management vpc-flow-logs-configs update

NAME
gcloud beta network-management vpc-flow-logs-configs update - updates one or more fields in an existing VPC Flow Logs configuration
SYNOPSIS
gcloud beta network-management vpc-flow-logs-configs update (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) [--aggregation-interval=AGGREGATION_INTERVAL] [--async] [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR] [--flow-sampling=FLOW_SAMPLING] [--metadata=METADATA] [--state=STATE] [--interconnect-attachment=INTERCONNECT_ATTACHMENT     | --vpn-tunnel=VPN_TUNNEL] [--labels=[LABELS,…]     | --update-labels=[UPDATE_LABELS,…] --clear-labels     | --remove-labels=[__REMOVE_LABELS,…]] [--metadata-fields=[METADATA_FIELDS,…]     | --add-metadata-fields=[ADD_METADATA_FIELDS,…] --clear-metadata-fields     | --remove-metadata-fields=[REMOVE_METADATA_FIELDS,…]] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Updates one or more fields in an existing VPC Flow Logs configuration.
EXAMPLES
To update the state field to be 'DISABLED' in the VPC Flow Logs configuration my-config, run:
gcloud beta network-management vpc-flow-logs-configs update my-config --location=global --state=DISABLED
POSITIONAL ARGUMENTS
VpcFlowLogsConfig resource - Identifier. Unique name of the configuration using the form: projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument vpc_flow_logs_config on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

VPC_FLOW_LOGS_CONFIG
ID of the vpcFlowLogsConfig or fully qualified identifier for the vpcFlowLogsConfig.

To set the vpc_flow_logs_config attribute:

  • provide the argument vpc_flow_logs_config on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION
The location id of the vpcFlowLogsConfig resource.

To set the location attribute:

  • provide the argument vpc_flow_logs_config on the command line with a fully specified name;
  • provide the argument --location on the command line.
FLAGS
Arguments for the aggregation interval.
--aggregation-interval=AGGREGATION_INTERVAL
The aggregation interval for the logs. Default value is INTERVAL_5_SEC. AGGREGATION_INTERVAL must be one of:
interval-1-min
Aggregate logs in 1m intervals.
interval-10-min
Aggregate logs in 10m intervals.
interval-15-min
Aggregate logs in 15m intervals.
interval-30-sec
Aggregate logs in 30s intervals.
interval-5-min
Aggregate logs in 5m intervals.
interval-5-sec
Aggregate logs in 5s intervals.
--async
Return immediately, without waiting for the operation in progress to complete.
Arguments for the description.
--description=DESCRIPTION
The user-supplied description of the VPC Flow Logs configuration. Maximum of 512 characters.
Arguments for the filter expr.
--filter-expr=FILTER_EXPR
Export filter used to define which VPC Flow Logs should be logged.
Arguments for the flow sampling.
--flow-sampling=FLOW_SAMPLING
The value of the field must be in (0, 1]. The sampling rate of VPC Flow Logs where 1.0 means all collected logs are reported. Setting the sampling rate to 0.0 is not allowed. If you want to disable VPC Flow Logs, use the state field instead. Default value is 1.0.
Arguments for the metadata.
--metadata=METADATA
Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default value is INCLUDE_ALL_METADATA. METADATA must be one of:
custom-metadata
Include only custom fields (specified in metadata_fields).
exclude-all-metadata
Exclude all metadata fields.
include-all-metadata
Include all metadata fields.
Arguments for the state.
--state=STATE
The state of the VPC Flow Log configuration. Default value is ENABLED. When creating a new configuration, it must be enabled. STATE must be one of:
disabled
When DISABLED, this configuration will not generate logs.
enabled
When ENABLED, this configuration will generate logs.
Arguments for the target resource.

At most one of these can be specified:

--interconnect-attachment=INTERCONNECT_ATTACHMENT
Traffic will be logged from the Interconnect Attachment. Format: projects/{project_id}/regions/{region}/interconnectAttachments/{name}
--vpn-tunnel=VPN_TUNNEL
Traffic will be logged from the VPN Tunnel. Format: projects/{project_id}/regions/{region}/vpnTunnels/{name}
Update labels.

At most one of these can be specified:

--labels=[LABELS,…]
Set labels to new value. Resource labels to represent user-provided metadata.
KEY
Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers.
VALUE
Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.
Shorthand Example:
--labels=string=string

JSON Example:

--labels='{"string": "string"}'

File Example:

--labels=path_to_file.(yaml|json)

--update-labels=[UPDATE_LABELS,…]
Update labels value or add key value pair. Resource labels to represent user-provided metadata.
KEY
Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers.
VALUE
Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.
Shorthand Example:
--update-labels=string=string

JSON Example:

--update-labels='{"string": "string"}'

File Example:

--update-labels=path_to_file.(yaml|json)

At most one of these can be specified:
--clear-labels
Clear labels value and set to empty map.
--remove-labels=[__REMOVE_LABELS,…]
Remove existing value from map labels.
Update metadata_fields.

At most one of these can be specified:

--metadata-fields=[METADATA_FIELDS,…]
Set metadata_fields to new value.
--add-metadata-fields=[ADD_METADATA_FIELDS,…]
Add new value to metadata_fields list.
At most one of these can be specified:
--clear-metadata-fields
Clear metadata_fields value and set to empty list.
--remove-metadata-fields=[REMOVE_METADATA_FIELDS,…]
Remove existing value from metadata_fields list.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

API REFERENCE
This command uses the networkmanagement/v1beta1 API. The full documentation for this API can be found at: https://cloud.google.com/
NOTES
This command is currently in beta and might change without notice.