NAME
    gcloud alpha edge-cloud networking routers add-bgp-peer - add a BGP peer to
        a Distributed Cloud Edge Network router

SYNOPSIS
    gcloud alpha edge-cloud networking routers add-bgp-peer
        (ROUTER : --location=LOCATION --zone=ZONE) --interface=INTERFACE
        --peer-asn=PEER_ASN --peer-name=PEER_NAME
        (--peer-ipv4-range=PEER_IPV4_RANGE | --peer-ipv6-range=PEER_IPV6_RANGE)
        [--async] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a BGP peer to a Distributed Cloud Edge Network router

EXAMPLES
    To create and add a BGP peer for the Distributed Cloud Edge Network router
    'my-router' in edge zone 'us-central1-edge-den1' , run:

        $ gcloud alpha edge-cloud networking routers add-bgp-peer \
          my-router --interface=my-int-r1 --peer-asn=33333 \
          --peer-name=peer1 --peer-ipv4-range=208.117.254.232/31 \
          --location=us-central1 --zone=us-central1-edge-den1

        $ gcloud alpha edge-cloud networking routers add-bgp-peer \
          my-router --interface=my-int-r1 --peer-asn=33333 \
          --peer-name=peer1 \
          --peer-ipv6-range=2001:0db8:85a3:0000:0000:8a2e:0370:7334/126 \
          --location=us-central1 --zone=us-central1-edge-den1

POSITIONAL ARGUMENTS
     Router resource - The router to which we add a bgp peer. 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 router 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.

       ROUTER
          ID of the router or fully qualified identifier for the router.

          To set the router attribute:
          ▸ provide the argument router on the command line.

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

       --location=LOCATION
          The Cloud location for the router.

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

       --zone=ZONE
          The zone of the router.

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

REQUIRED FLAGS
     --interface=INTERFACE
        The name of the interface for this BGP peer.

     --peer-asn=PEER_ASN
        The BGP autonomous system number (ASN) for this BGP peer. Must be a
        16-bit or 32-bit private ASN as defined in
        https://tools.ietf.org/html/rfc6996, for example --asn=64512.

     --peer-name=PEER_NAME
        The name of the new BGP peer being added.

     Exactly one of these must be specified:

       --peer-ipv4-range=PEER_IPV4_RANGE
          The IPv4 link-local address range of the peer router.

       --peer-ipv6-range=PEER_IPV6_RANGE
          The IPv6 link-local address range of the peer router.

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

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.

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

        $ gcloud edge-cloud networking routers add-bgp-peer

