feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/__init__.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""The command group for Distributed Cloud Edge Network routers resource."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Routers(base.Group):
+  """Manage Distributed Cloud Edge Network routers."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/add_bgp_peer.py

@@ -0,0 +1,121 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to add a BGP peer to a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+from googlecloudsdk.command_lib.edge_cloud.networking.routers import flags as routers_flags
+from googlecloudsdk.core import log
+
+DESCRIPTION = ('Create a BGP peer to a Distributed Cloud Edge Network router')
+
+EXAMPLES_GA = """\
+    To create and add a BGP peer for the Distributed Cloud Edge Network router
+    'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} 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
+   """
+
+EXAMPLES_ALPHA = """\
+    To create and add a BGP peer for the Distributed Cloud Edge Network router
+    'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} 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
+
+        $ {command} 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
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class AddBgpPeerAlpha(base.UpdateCommand):
+  """Add a BGP peer to a Distributed Cloud Edge Network router.
+
+  *{command}* is used to add a BGP peer to a Distributed Cloud Edge Network
+  router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES_ALPHA}
+
+  @classmethod
+  def Args(cls, parser):
+    resource_args.AddRouterResourceArg(
+        parser, 'to which we add a bgp peer', True
+    )
+
+    routers_flags.AddBgpPeerArgs(
+        parser,
+        for_update=False,
+        enable_peer_ipv6_range=True,
+    )
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    update_req_op = routers_client.AddBgpPeer(router_ref, args)
+
+    async_ = args.async_
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.'
+      )
+      return response
+
+    log.status.Print(
+        'Updating [{0}] with operation [{1}].'.format(
+            router_ref.RelativeName(), update_req_op.name
+        )
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class AddBgpPeer(base.UpdateCommand):
+  """Add a BGP peer to a Distributed Cloud Edge Network router.
+
+  *{command}* is used to add a BGP peer to a Distributed Cloud Edge Network
+  router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES_GA}
+
+  @classmethod
+  def Args(cls, parser):
+    resource_args.AddRouterResourceArg(
+        parser, 'to which we add a bgp peer', True
+    )
+
+    routers_flags.AddBgpPeerArgs(parser)
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    update_req_op = routers_client.AddBgpPeer(router_ref, args)
+
+    async_ = args.async_
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.')
+      return response
+
+    log.status.Print('Updating [{0}] with operation [{1}].'.format(
+        router_ref.RelativeName(), update_req_op.name))

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/add_interface.py

@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to add an interface to a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+from googlecloudsdk.command_lib.edge_cloud.networking.routers import flags as routers_flags
+from googlecloudsdk.core import log
+
+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:
+
+        $ {command} 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:
+
+         $ {command} my-router --interface-name=my-int-r2 --subnetwork=my-subnet --location=us-central1 --zone=us-central1-edge-den1
+
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class AddInterface(base.UpdateCommand):
+  """Add an interface to a Distributed Cloud Edge Network router.
+
+  *{command}* is used to add an interface to a Distributed Cloud Edge Network
+  router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @classmethod
+  def Args(cls, parser):
+    resource_args.AddRouterResourceArg(
+        parser, 'to which we add an interface', True
+    )
+    routers_flags.AddInterfaceArgs(parser)
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    update_req_op = routers_client.AddInterface(router_ref, args)
+
+    async_ = getattr(args, 'async_', False)
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.'
+      )
+      return response
+
+    log.status.Print(
+        'Updating [{0}] with operation [{1}].'.format(
+            router_ref.RelativeName(), update_req_op.name
+        )
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/create.yaml

@@ -0,0 +1,55 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Create a Distributed Cloud Edge Network router.
+    description: |
+      Create a new Distributed Cloud Edge Network router.
+    examples: |
+      To create a router called 'my-router' with asn 65555 in edge zone 'us-central1-edge-den1', run:
+
+        $ {command} my-router --network=my-network --location=us-central1 --zone=us-central1-edge-den1
+            --asn=65555
+
+  request:
+    collection: edgenetwork.projects.locations.zones.routers
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.edge_cloud.networking.resources:SetResourcesPathForRouter
+
+  arguments:
+    resource:
+      help_text: Distributed Cloud Edge Network router to create.
+      # The following should point to the resource argument definition under
+      # your surface's command_lib directory.:
+      spec: !REF googlecloudsdk.command_lib.edge_cloud.networking.resources:router
+
+    params:
+    - arg_name: network
+      api_field: router.network
+      required: true
+      help_text: |
+        The network that this subnetwork belongs to.
+    - arg_name: asn
+      api_field: router.bgp.asn
+      required: true
+      help_text: |
+        The locally assigned BGP ASN.
+    - arg_name: keepalive-interval-in-seconds
+      api_field: router.bgp.keepaliveIntervalInSeconds
+      type: int
+      default: 20
+      hidden: true
+      help_text: |
+        The interval in seconds between BGP keepalive messages that are sent to the peer.
+    - arg_name: description
+      api_field: router.description
+      help_text: |
+        An optional, textual description for the router.
+    labels:
+      api_field: router.labels
+
+  async:
+    collection: edgenetwork.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/delete.yaml

@@ -0,0 +1,27 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Delete a Distributed Cloud Edge Network router.
+    description: |
+      Delete a Distributed Cloud Edge Network router.
+    examples: |
+      To delete a router called 'my-router' in edge zone 'us-central1-edge-den1', run:
+
+        $ {command} my-router --location=us-central1 --zone=us-central1-edge-den1
+
+  request:
+    collection: edgenetwork.projects.locations.zones.routers
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      help_text: Distributed Cloud Edge Network router to delete.
+      # The following should point to the resource argument definition under your
+      # surface's command_lib directory.:
+      spec: !REF googlecloudsdk.command_lib.edge_cloud.networking.resources:router
+
+  async:
+    collection: edgenetwork.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/describe.yaml

@@ -0,0 +1,24 @@
+release_tracks: [ALPHA, GA]
+
+help_text:
+  brief: Show details about the Distributed Cloud Edge Network router.
+  description: |
+    Show details about the Distributed Cloud Edge Network router.
+  examples: |
+    To show details about a router named 'my-router' in edge zone 'us-central1-edge-den1', run:
+
+      $ {command} my-router --location=us-central1 --zone=us-central1-edge-den1
+
+request:
+  collection: edgenetwork.projects.locations.zones.routers
+  ALPHA:
+    api_version: v1alpha1
+  GA:
+    api_version: v1
+
+arguments:
+  resource:
+    help_text: The router you want to describe.
+    # The following should point to the resource argument definition under your
+    # surface's command_lib directory.:
+    spec: !REF googlecloudsdk.command_lib.edge_cloud.networking.resources:router

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/get_status.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to get the status of a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+
+DESCRIPTION = (
+    'Get the status of a specified Distributed Cloud Edge Network router.')
+EXAMPLES = """\
+    To get the status of the Distributed Cloud Edge Network router
+    'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --location=us-central1 --zone=us-central1-edge-den1
+
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class GetStatus(base.Command):
+  """Get the status of a specified Distributed Cloud Edge Network router.
+
+  *{command}* is used to get the status of a Distributed Cloud Edge Network
+  router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddRouterResourceArg(parser, 'to get status', True)
+
+  def _PreprocessResult(self, router_status):
+    """Make the nextHopReachable value explicit for each route status."""
+    # This is necessary because if nextHopReachable == false, then when it's
+    # serialized by the server it will not be included, but we want to print it
+    # out explicitly, whether it's true or false.
+    for route_status in router_status.result.staticRouteStatus:
+      route_status.nextHopReachable = bool(route_status.nextHopReachable)
+    return router_status
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    if self.ReleaseTrack() == base.ReleaseTrack.GA:
+      return routers_client.GetStatus(router_ref)
+    return self._PreprocessResult(routers_client.GetStatus(router_ref))

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/list.yaml

@@ -0,0 +1,36 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: List Distributed Cloud Edge Network routers.
+    description: |
+      List Distributed Cloud Edge Network routers.
+    examples: |
+      To list the routers in edge zone 'us-central1-edge-den1', run:
+
+        $ {command} --location=us-central1 --zone=us-central1-edge-den1
+
+  request:
+    collection: edgenetwork.projects.locations.zones.routers
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Parent Distributed Cloud Edge Network zone to list all contained Distributed Cloud Edge Network routers.
+      # The following should point to the parent resource argument definition
+      # under your surface's command_lib directory.:
+      spec: !REF googlecloudsdk.command_lib.edge_cloud.networking.resources:zone
+
+  output:
+    format: |
+      table(
+        name.basename():label=NAME,
+        network.basename():label=NETWORK,
+        bgp.asn:label=ASN,
+        state.sub("STATE_", ""):label=STATE
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/remove_bgp_peer.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to remove a BGP peer from a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+from googlecloudsdk.core import log
+
+DESCRIPTION = (
+    'Delete a list of BGP peer from a Distributed Cloud Edge Network router'
+)
+EXAMPLES = """\
+    To delete a BGP peer 'peer1' from the Distributed Cloud Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --peer-name=peer1 --location=us-central1 --zone=us-central1-edge-den1
+
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class RemoveBgpPeer(base.UpdateCommand):
+  """Remove a BGP peer from a Distributed Cloud Edge Network router.
+
+  *{command}* is used to delete a BGP peer from a Distributed Cloud
+  Edge
+  Network router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddRouterResourceArg(
+        parser, 'from which we delete a BGP peer', True
+    )
+    bgp_peer_parser = parser.add_mutually_exclusive_group(required=True)
+    bgp_peer_parser.add_argument(
+        '--peer-names',
+        type=arg_parsers.ArgList(),
+        metavar='PEER_NAME',
+        help="""The list of names for peers being removed.
+        Only single value allowed currently.
+        """,
+    )
+    bgp_peer_parser.add_argument(
+        '--peer-name', help='The name of the BGP peer being removed.'
+    )
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    update_req_op = routers_client.RemoveBgpPeer(router_ref, args)
+
+    async_ = args.async_
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.'
+      )
+      return response
+
+    log.status.Print(
+        'Updating [{0}] with operation [{1}].'.format(
+            router_ref.RelativeName(), update_req_op.name
+        )
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/remove_interface.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to an interface on a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+from googlecloudsdk.core import log
+
+DESCRIPTION = ('Remove an interface on a Distributed Cloud Edge '
+               'Network router.')
+EXAMPLES = """\
+    To remove the interface 'my-int-r1' on Distributed Cloud Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --interface-name=my-int-r1 --location=us-central1 --zone=us-central1-edge-den1
+
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class RemoveInterface(base.UpdateCommand):
+  """remove an interface on a Distributed Cloud Edge Network router.
+
+  *{command}* is used to remove an interface to a Distributed Cloud Edge
+  Network router.
+  """
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddRouterResourceArg(parser,
+                                       'from which we remove an interface',
+                                       True)
+    interface_parser = parser.add_mutually_exclusive_group(required=True)
+    interface_parser.add_argument(
+        '--interface-names',
+        type=arg_parsers.ArgList(),
+        metavar='INTERFACE_NAME',
+        help='The list of names for interfaces being removed.')
+    interface_parser.add_argument(
+        '--interface-name', help='The name of the interface being removed.')
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+    update_req_op = routers_client.RemoveInterface(router_ref, args)
+
+    async_ = getattr(args, 'async_', False)
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.')
+      return response
+
+    log.status.Print('Updating [{0}] with operation [{1}].'.format(
+        router_ref.RelativeName(), update_req_op.name))

gcloud auth application-default login/google-cloud-sdk/lib/surface/edge_cloud/networking/routers/update.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command to update a Distributed Cloud Edge Network router."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.edge_cloud.networking.routers import routers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.edge_cloud.networking import resource_args
+from googlecloudsdk.command_lib.edge_cloud.networking.routers import flags as routers_flags
+from googlecloudsdk.core import log
+
+DESCRIPTION = """Update a Distributed Cloud Edge Network router.
+
+Note that `update` operations are not thread-safe, meaning that if more than one
+user is updating a router at a time, there can be race conditions. Please ensure
+that at most one `update` operation is being applied to a given router at a
+time.
+"""
+
+EXAMPLES = """\
+    To add a northbound route advertisement for destination range 8.8.0.0/16 for Distributed Cloud Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --add-advertisement-ranges=8.8.0.0/16 --location=us-central1 --zone=us-central1-edge-den1
+
+    To remove a northbound route advertisement for destination range 8.8.0.0/16 for Distributed Cloud Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --remove-advertisement-ranges=8.8.0.0/16 --location=us-central1 --zone=us-central1-edge-den1
+
+    To replace the set of route advertisements with just 8.8.0.0/16 and 1.1.0.0/16, in Distributed Cloud Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run:
+
+        $ {command} my-router --set-advertisement-ranges=8.8.0.0/16,1.1.0.0/16 --location=us-central1 --zone=us-central1-edge-den1
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Update(base.UpdateCommand):
+  """Update a Distributed Cloud Edge Network router.
+
+  *{command}* is used update a Distributed Cloud Edge Network router.
+  """
+
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddRouterResourceArg(parser, 'to be updated', True)
+    routers_flags.AddUpdateArgs(parser)
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    routers_client = routers.RoutersClient(self.ReleaseTrack())
+    router_ref = args.CONCEPTS.router.Parse()
+
+    if not self.has_routes_arg(args):
+      return
+
+    update_req_op = routers_client.ChangeAdvertisements(router_ref, args)
+
+    async_ = getattr(args, 'async_', False)
+    if not async_:
+      response = routers_client.WaitForOperation(update_req_op)
+      log.UpdatedResource(
+          router_ref.RelativeName(), details='Operation was successful.')
+      return response
+
+    log.status.Print('Updating [{0}] with operation [{1}].'.format(
+        router_ref.RelativeName(), update_req_op.name))
+
+  def has_routes_arg(self, args):
+    relevant_args = [
+        args.add_advertisement_ranges,
+        args.remove_advertisement_ranges,
+        args.set_advertisement_ranges,
+    ]
+    filtered = filter(None, relevant_args)
+    number_found = sum(1 for _ in filtered)
+    if number_found == 0:
+      return False
+    if number_found == 1:
+      return True
+
+    raise ValueError(
+        'Invalid argument: Expected at most one of add_advertisement_ranges '
+        'remove_advertisement_ranges set_advertisement_ranges')