NAME
    gcloud edge-cloud networking routers add-interface - add an interface to a
        Distributed Cloud Edge Network router

SYNOPSIS
    gcloud edge-cloud networking routers add-interface
        (ROUTER : --location=LOCATION --zone=ZONE)
        --interface-name=INTERFACE_NAME
        (--loopback-ip-addresses=[LOOPBACK_IP_ADDRESSES,...]
          | --subnetwork=SUBNETWORK
          | --interconnect-attachment=INTERCONNECT_ATTACHMENT
          --ip-address=IP_ADDRESS --ip-mask-length=IP_MASK_LENGTH) [--async]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Create an interface to a Distributed Cloud Edge Network router.

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

        $ gcloud edge-cloud networking routers add-interface my-router \
          --interface-name=my-int-r1 \
          --interconnect-attachment=my-link-attachment \
          --ip-address=208.117.254.233 --ip-mask-length=31 \
          --location=us-central1 --zone=us-central1-edge-den1

    To create and add a southbound interface for Distributed Cloud Edge Network
    router 'my-router' in edge zone 'us-central1-edge-den1', run:

        $ gcloud edge-cloud networking routers add-interface my-router \
         --interface-name=my-int-r2 --subnetwork=my-subnet \
         --location=us-central1 --zone=us-central1-edge-den1

POSITIONAL ARGUMENTS
     Router resource - The router to which we add an interface. 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-name=INTERFACE_NAME
        The name of the interface being added.

     The argument group for configuring the interface for the router.

     Exactly one of these must be specified:

       The argument group for adding loopback interfaces to edge router.

       --loopback-ip-addresses=[LOOPBACK_IP_ADDRESSES,...]
          The list of ip ranges for the loopback interface.

       The argument group for adding southbound interfaces to edge router.

       --subnetwork=SUBNETWORK
          Subnetwork of the interface being added.

       The argument group for adding northbound interfaces to edge router.

       --interconnect-attachment=INTERCONNECT_ATTACHMENT
          Interconnect attachment of the interface being added.

       --ip-address=IP_ADDRESS
          Link-local address of the router for this interface.

       --ip-mask-length=IP_MASK_LENGTH
          Subnet mask for the link-local IP range of the interface. The
          interface IP address and BGP peer IP address must be selected from
          the subnet defined by this link-local range.

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

        $ gcloud alpha edge-cloud networking routers add-interface

