NAME
    gcloud alpha network-services multicast-consumer-associations create -
        create a multicast consumer association

SYNOPSIS
    gcloud alpha network-services multicast-consumer-associations create
        (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION)
        --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION
        --network=NETWORK [--async] [--description=DESCRIPTION]
        [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a multicast consumer association in the specified location
    of the current project.

EXAMPLES
    Create a multicast consumer association with the name
    'my-multicast-consumer-association', multicast-domain-activation
    'path-to-mda', network 'path-to-network', and location 'zone'.

        $ gcloud alpha network-services multicast-consumer-associations \
            create my-multicast-consumer-association \
            --multicast-domain-activation=path-to-mda \
            --network=path-to-network --location=zone

POSITIONAL ARGUMENTS
     Multicast consumer association resource - Name of the multicast consumer
     association to be created. 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 multicast_consumer_association 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.

       MULTICAST_CONSUMER_ASSOCIATION
          ID of the multicast consumer association or fully qualified
          identifier for the multicast consumer association.

          To set the multicast_consumer_association attribute:
          ▸ provide the argument multicast_consumer_association 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.

          To set the location attribute:
          ▸ provide the argument multicast_consumer_association on the
            command line with a fully specified name;
          ▸ provide the argument --location on the command line.

REQUIRED FLAGS
     --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION
        The multicast domain activation to be used.

     --network=NETWORK
        The path of the multicast consumer VPC network.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --description=DESCRIPTION
        The description for the multicast consumer association.

     --labels=[KEY=VALUE,...]
        List of label KEY=VALUE pairs to add.

        Keys must start with a lowercase character and contain only hyphens
        (-), underscores (_), lowercase characters, and numbers. Values must
        contain only hyphens (-), underscores (_), lowercase characters, and
        numbers.

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

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud network-services multicast-consumer-associations create

        $ gcloud beta network-services multicast-consumer-associations create

