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

gcloud auth application-default login/google-cloud-sdk/lib/surface/logging/links/__init__.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 links command group for the Cloud Logging CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class Links(base.Group):
+  """Manage linked datasets.
+
+  Commands for managing linked datasets. A linked BigQuery dataset contains log
+  data for the linked dataset's parent log bucket.
+  """
+
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/logging/links/create.py

@@ -0,0 +1,112 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+
+"""'logging links create' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.logging import util
+from googlecloudsdk.api_lib.util import waiter
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.core import log
+from googlecloudsdk.core import resources
+
+DETAILED_HELP = {
+    'DESCRIPTION': """
+        Create a linked dataset for a log bucket.
+    """,
+    'EXAMPLES': """
+     To create a linked dataset in a project, run:
+
+        $ {command} my-link --bucket=my-bucket --location=global
+    """,
+}
+
+
+class Create(base.CreateCommand):
+  """Create a linked dataset on an analytics log bucket."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    parser.add_argument('LINK_ID', help='ID of the linked dataset to create.')
+    parser.add_argument(
+        '--description', help='A textual description for the linked dataset.'
+    )
+    util.AddParentArgs(parser, 'linked dataset to create')
+    util.AddBucketLocationArg(
+        parser,
+        True,
+        'Location of the bucket that will hold the linked datasert.',
+    )
+    parser.add_argument(
+        '--bucket',
+        required=True,
+        type=arg_parsers.RegexpValidator(r'.+', 'must be non-empty'),
+        help='ID of the bucket that will hold the linked dataset',
+    )
+    base.ASYNC_FLAG.AddToParser(parser)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Linked dataset creation operation.
+    """
+    link_data = {}
+    if args.IsSpecified('description'):
+      link_data['description'] = args.description
+
+    client = util.GetClient()
+    create_op = client.projects_locations_buckets_links.Create(
+        util.GetMessages().LoggingProjectsLocationsBucketsLinksCreateRequest(
+            linkId=args.LINK_ID,
+            parent=util.CreateResourceName(
+                util.CreateResourceName(
+                    util.GetProjectResource(args.project).RelativeName(),
+                    'locations',
+                    args.location,
+                ),
+                'buckets',
+                args.bucket,
+            ),
+            link=util.GetMessages().Link(**link_data),
+        )
+    )
+    if args.async_:
+      log.CreatedResource(create_op.name, 'link', is_async=True)
+      return create_op
+    else:
+      create_op_ref = resources.REGISTRY.ParseRelativeName(
+          create_op.name,
+          collection='logging.projects.locations.operations',
+      )
+      return waiter.WaitFor(
+          waiter.CloudOperationPollerNoResources(
+              client.projects_locations_operations
+          ),
+          create_op_ref,
+          'Waiting for operation [{}] to complete'.format(create_op.name),
+      )
+
+
+Create.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/logging/links/delete.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+
+"""'logging links delete' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.logging import util
+from googlecloudsdk.api_lib.util import waiter
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.core import log
+from googlecloudsdk.core import resources
+
+DETAILED_HELP = {
+    'DESCRIPTION': """
+        Delete a bucket's linked dataset.
+    """,
+    'EXAMPLES': """
+     To delete a bucket's linked dataset, run:
+
+        $ {command} my-link --bucket=my-bucket --location=global
+    """,
+}
+
+
+class Delete(base.DeleteCommand):
+  """Delete a linked dataset."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    parser.add_argument('LINK_ID', help='ID of the linked dataset to delete.')
+    util.AddBucketLocationArg(parser, True, 'Location of the bucket.')
+    util.AddParentArgs(parser, 'linked dataset to delete')
+    parser.add_argument(
+        '--bucket',
+        required=True,
+        type=arg_parsers.RegexpValidator(r'.+', 'must be non-empty'),
+        help='ID of bucket',
+    )
+    base.ASYNC_FLAG.AddToParser(parser)
+    parser.display_info.AddCacheUpdater(None)
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Linked dataset delete operation.
+    """
+    client = util.GetClient()
+    delete_op = client.projects_locations_buckets_links.Delete(
+        util.GetMessages().LoggingProjectsLocationsBucketsLinksDeleteRequest(
+            name=util.CreateResourceName(
+                util.CreateResourceName(
+                    util.GetBucketLocationFromArgs(args),
+                    'buckets',
+                    args.bucket,
+                ),
+                'links',
+                args.LINK_ID,
+            )
+        )
+    )
+    if args.async_:
+      log.DeletedResource(delete_op.name, 'link', is_async=True)
+      return delete_op
+    else:
+      delete_op_ref = resources.REGISTRY.ParseRelativeName(
+          delete_op.name,
+          collection='logging.projects.locations.operations',
+      )
+      return waiter.WaitFor(
+          waiter.CloudOperationPollerNoResources(
+              client.projects_locations_operations
+          ),
+          delete_op_ref,
+          'Waiting for operation [{}] to complete'.format(delete_op.name),
+      )
+
+Delete.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/logging/links/describe.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""'logging buckets describe' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.logging import util
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+
+DETAILED_HELP = {
+    'DESCRIPTION': """
+        Display information about a linked dataset.
+    """,
+    'EXAMPLES': """
+     To describe a linked dataset in a project, run:
+
+        $ {command} my-link --bucket=my-bucket --location=global
+    """,
+}
+
+
+class Describe(base.DescribeCommand):
+  """Display information about a linked dataset."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    parser.add_argument('LINK_ID', help='Id of the linked dataset to describe.')
+    util.AddParentArgs(parser, 'linked dataset to describe')
+    util.AddBucketLocationArg(parser, True, 'Location of the bucket.')
+    parser.add_argument(
+        '--bucket',
+        required=True,
+        type=arg_parsers.RegexpValidator(r'.+', 'must be non-empty'),
+        help='ID of bucket',
+    )
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      The specified linked dataset
+    """
+    return util.GetClient().projects_locations_buckets_links.Get(
+        util.GetMessages().LoggingProjectsLocationsBucketsLinksGetRequest(
+            name=util.CreateResourceName(
+                util.CreateResourceName(
+                    util.GetBucketLocationFromArgs(args), 'buckets', args.bucket
+                ),
+                'links',
+                args.LINK_ID,
+            )
+        )
+    )
+
+
+Describe.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/logging/links/list.py

@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+
+"""'logging links list' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.logging import util
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+
+DETAILED_HELP = {
+    'DESCRIPTION': """
+        List the linked datasets created for a bucket.
+    """,
+    'EXAMPLES': """
+     To list the linked datasets created for a bucket, run:
+
+        $ {command}
+    """,
+}
+
+
+class List(base.ListCommand):
+  """List created linked datasets on the specified bucket."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+
+    util.AddParentArgs(parser, 'linked datasets to list')
+    util.AddBucketLocationArg(parser, True, 'Location of the specified bucket')
+    parser.add_argument(
+        '--bucket',
+        required=True,
+        type=arg_parsers.RegexpValidator(r'.+', 'must be non-empty'),
+        help='ID of bucket',
+    )
+    parser.display_info.AddFormat(
+        'table(name.segment(-1):label=LINK_ID, create_time)'
+    )
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Yields:
+      The list of linked datasets.
+    """
+    result = util.GetClient().projects_locations_buckets_links.List(
+        util.GetMessages().LoggingProjectsLocationsBucketsLinksListRequest(
+            parent=util.CreateResourceName(
+                util.GetBucketLocationFromArgs(args), 'buckets', args.bucket
+            )
+        )
+    )
+    for link in result.links:
+      yield link
+
+
+List.detailed_help = DETAILED_HELP