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

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastream/routes/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+
+"""Routes command group for Datastream."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA)
+class Routes(base.Group):
+  """Manage Datastream routes.
+
+  Commands for managing Datastream routes.
+  """

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastream/routes/create.py

@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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 create a datastream route."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.datastream import routes
+from googlecloudsdk.api_lib.datastream import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.datastream import flags
+from googlecloudsdk.command_lib.datastream import resource_args
+from googlecloudsdk.command_lib.datastream.routes import flags as routes_flags
+
+
+DESCRIPTION = ('Create a Datastream private connection route')
+EXAMPLES = """\
+    To create a route called 'my-route', run:
+
+        $ {command} my-route --location=us-central1 --private-connection=private-connection --display-name=my-display-name --destination-address=addr.path.to.somewhere --destination-port=33665
+
+
+   """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.Command):
+  """Create a Datastream private connection route."""
+  detailed_help = {'DESCRIPTION': DESCRIPTION, 'EXAMPLES': EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    resource_args.AddRouteResourceArg(parser, 'to create')
+
+    routes_flags.AddDisplayNameFlag(parser)
+    routes_flags.AddDestinationAddressFlag(parser)
+    routes_flags.AddDestinationPortFlag(parser)
+
+    flags.AddLabelsCreateFlags(parser)
+
+  def Run(self, args):
+    """Create a Datastream route.
+
+    Args:
+      args: argparse.Namespace, The arguments that this command was invoked
+        with.
+
+    Returns:
+      A dict object representing the operations resource describing the create
+      operation if the create was successful.
+    """
+    route_ref = args.CONCEPTS.route.Parse()
+    parent_ref = route_ref.Parent().RelativeName()
+
+    routes_client = routes.RoutesClient()
+    result_operation = routes_client.Create(
+        parent_ref, route_ref.routesId, args)
+
+    client = util.GetClientInstance()
+    messages = util.GetMessagesModule()
+    resource_parser = util.GetResourceParser()
+
+    operation_ref = resource_parser.Create(
+        'datastream.projects.locations.operations',
+        operationsId=result_operation.name,
+        projectsId=route_ref.projectsId,
+        locationsId=route_ref.locationsId)
+
+    return client.projects_locations_operations.Get(
+        messages.DatastreamProjectsLocationsOperationsGetRequest(
+            name=operation_ref.operationsId))
+
+
+@base.Deprecate(
+    is_removed=False,
+    warning=('Datastream beta version is deprecated. Please use`gcloud '
+             'datastream routes create` command instead.')
+)
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create a Datastream private connection route."""
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastream/routes/delete.yaml

@@ -0,0 +1,26 @@
+- release_tracks: [BETA, GA]
+  BETA:
+    deprecate:
+      is_removed: false
+      warning: |
+        This command has been deprecated.
+        Use `gcloud datastream routes delete` instead.
+  help_text:
+    brief: |
+      Delete a Datastream private connection route.
+    description: |
+      Deletes a Datastream private connection route.
+    examples: |
+      To delete a Datastream private connection route:
+
+          $ {command} ROUTE --location=us-central1
+
+  request:
+    collection: datastream.projects.locations.privateConnections.routes
+    api_version: v1
+
+  arguments:
+    resource:
+      help_text: |
+        The Route to delete.
+      spec: !REF googlecloudsdk.command_lib.datastream.resources:route

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastream/routes/describe.yaml

@@ -0,0 +1,26 @@
+release_tracks: [BETA, GA]
+BETA:
+  deprecate:
+    is_removed: false
+    warning: |
+      This command has been deprecated.
+      Use `gcloud datastream routes describe` instead.
+
+help_text:
+  brief: Show details about the route.
+  description: Show details about the route.
+  examples: |
+    To show details about a device, run:
+
+      $ {command} my-route --private-connection=pc --location=us-central1
+
+request:
+  collection: datastream.projects.locations.privateConnections.routes
+  api_version: v1
+
+arguments:
+  resource:
+    help_text: The route 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.datastream.resources:route

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastream/routes/list.yaml

@@ -0,0 +1,41 @@
+- release_tracks: [BETA, GA]
+  BETA:
+    deprecate:
+      is_removed: false
+      warning: |
+        This command has been deprecated.
+        Use `gcloud datastream routes list` instead.
+  help_text:
+    brief: List Datastream routes.
+    description: |
+      List Datastream routes.
+    examples: |
+      To list the routes, run:
+
+        $ {command} --private-connection=pc --location=us-central1
+
+  request:
+    collection: datastream.projects.locations.privateConnections.routes
+    api_version: v1
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Parent Datastream location to list all contained Datastream routes.
+      # The following should point to the parent resource argument definition
+      # under your surface's command_lib directory:
+      spec: !REF googlecloudsdk.command_lib.datastream.resources:private_connection
+
+  output:
+    format: |
+      table(
+        name.basename():label=NAME,
+        createTime:label=CREATETIME,
+        destinationAddress:label=DESTINATIONADDRESS,
+        destinationPort:label=DESTINATIONPORT,
+        displayName:label=DISPLAYNAME,
+        labels:label=LABELS,
+        updateTime:label=UPDATETIME
+      )