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 --organization=ORGANIZATION)
        [--aggregation-interval=AGGREGATION_INTERVAL] [--async]
        [--cross-project-metadata=CROSS_PROJECT_METADATA]
        [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR]
        [--flow-sampling=FLOW_SAMPLING] [--metadata=METADATA] [--state=STATE]
        [--interconnect-attachment=INTERCONNECT_ATTACHMENT | --network=NETWORK
          | --subnet=SUBNET | --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 --organization=<my-org-number> \
            --state=DISABLED

    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.
     The name can have one of the following forms:

      ◆ For project-level configurations:
        projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}

      ◆ For organization-level configurations:
        organizations/{organization_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 resource can be one of the
        following types:
        [networkmanagement.organizations.locations.vpcFlowLogsConfigs,
        networkmanagement.projects.locations.vpcFlowLogsConfigs].

     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.

       --organization=ORGANIZATION
          The organization id of the vpcFlowLogsConfig resource.

          To set the organization attribute:
          ▸ provide the argument vpc_flow_logs_config on the command line
            with a fully specified name;
          ▸ provide the argument --organization on the command line. Must be
            specified for resource of type
            [networkmanagement.organizations.locations.vpcFlowLogsConfigs].

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 cross project metadata.

     --cross-project-metadata=CROSS_PROJECT_METADATA
        Determines whether to include cross project annotations in the logs.
        This field is available only for organization configurations. If not
        specified in org configs will be set to CROSS_PROJECT_METADATA_ENABLED.
        CROSS_PROJECT_METADATA must be one of:

         cross-project-metadata-disabled
            When CROSS_PROJECT_METADATA_DISABLED, metadata from other projects
            will not be included in the logs.
         cross-project-metadata-enabled
            When CROSS_PROJECT_METADATA_ENABLED, metadata from other projects
            will be included in the logs.

     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. Setting
        state=DISABLED will pause the log generation for this config. 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}

       --network=NETWORK
          Traffic will be logged from VMs, VPN tunnels and Interconnect
          Attachments within the network. Format:
          projects/{project_id}/global/networks/{name}

       --subnet=SUBNET
          Traffic will be logged from VMs within the subnetwork. Format:
          projects/{project_id}/regions/{region}/subnetworks/{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)

       Or at least one of these can be specified:

         --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. Sets remove_labels value.

              Shorthand Example:

                  --remove-labels=string,string

              JSON Example:

                  --remove-labels=["string"]

              File Example:

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

     Update metadata_fields.

     At most one of these can be specified:

       --metadata-fields=[METADATA_FIELDS,...]
          Set metadata_fields to new value.

       Or at least one of these can be specified:

         --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. This
    variant is also available:

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

