gcloud-help/gcloud/network-management/vpc-flow-logs-configs/create

NAME
    gcloud network-management vpc-flow-logs-configs create - creates a new VPC
        Flow Logs configuration in the specified project

SYNOPSIS
    gcloud network-management vpc-flow-logs-configs create
        (VPC_FLOW_LOGS_CONFIG : --location=LOCATION)
        [--aggregation-interval=AGGREGATION_INTERVAL] [--async]
        [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR]
        [--flow-sampling=FLOW_SAMPLING] [--labels=[LABELS,...]]
        [--metadata=METADATA] [--metadata-fields=[METADATA_FIELDS,...]]
        [--state=STATE]
        [--interconnect-attachment=INTERCONNECT_ATTACHMENT
          | --vpn-tunnel=VPN_TUNNEL] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Creates a new VPC Flow Logs configuration in the specified project. The
    target-resource project must be the same as the configuration project.

EXAMPLES
    To create a new VPC Flow Logs configuration my-config in project my-project
    for a VLAN attachment for Cloud Interconnect, run:

        $ gcloud network-management vpc-flow-logs-configs create my-config \
            --location=global \
            --interconnect-attachment="projects/my-project/regions/{region}/\
        interconnectAttachments/{interconnect_attachment_id}"

    To create a new VPC Flow Logs configuration my-config in project my-project
    for a Cloud VPN tunnel, run:

        $ gcloud network-management vpc-flow-logs-configs create my-config \
            --location=global \
            --vpn-tunnel="projects/my-project/regions/{region}/vpnTunnels/{v\
        pn_tunnel_id}"

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.

     --labels=[LABELS,...]
        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)

     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.

     --metadata-fields=[METADATA_FIELDS,...]
        Custom metadata fields to include in the reported VPC flow logs. Can
        only be specified if "metadata" was set to CUSTOM_METADATA.

     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}

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/v1 API. The full documentation for
    this API can be found at: https://cloud.google.com/

NOTES
    This variant is also available:

        $ gcloud beta network-management vpc-flow-logs-configs create