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

gcloud auth application-default login/google-cloud-sdk/lib/surface/redis/clusters/backups/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 group for backups of Cloud Memorystore Cluster for Redis."""
+
+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.BETA,
+                    base.ReleaseTrack.GA)
+@base.DefaultUniverseOnly
+class Backups(base.Group):
+  """Manage backups of Memorystore for Redis Cluster instances."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/redis/clusters/backups/delete.yaml

@@ -0,0 +1,40 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  help_text:
+    brief: |
+      Delete a Memorystore for Redis Cluster backup.
+    description: |
+      Delete a Memorystore for Redis Cluster backup.
+
+      This command can fail for the following reasons:
+        * The backup specified does not exist.
+        * The active account does not have permission to access the given
+          backup.
+    examples: |
+      To delete a backup with the name `my-backup` under backup collection `my-backup-collection`
+      in `us-central1` region, run:
+
+      $ {command} my-backup --backup-collection=my-backup-collection --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.redis.resources:backup
+      help_text:
+        Arguments and flags that specify the Redis backup you want to delete.
+
+  async:
+    collection: redis.projects.locations.operations
+
+  input:
+    confirmation_prompt: |
+      You are about to delete backup [{__name__}] in [{locationsId}].
+      Any associated data will be lost.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+    collection: redis.projects.locations.backupCollections.backups

gcloud auth application-default login/google-cloud-sdk/lib/surface/redis/clusters/backups/describe.yaml

@@ -0,0 +1,34 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  help_text:
+    brief: |
+      Show metadata for a Memorystore for Redis Cluster backup.
+    description: |
+      Show metadata for a Memorystore for Redis Cluster backup.
+
+      Displays all metadata associated with a backup given a valid backup name.
+
+      This command can fail for the following reasons:
+        * The backup specified does not exist.
+        * The active account does not have permission to access the given
+          backup.
+    examples: |
+      To display the metadata for a backup named `my-backup`, under `my-collection`
+      backup collection, in `us-central1` region, run:
+
+      $ {command} my-backup --backup_collection=my-collection --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.redis.resources:backup
+      help_text: |
+        Arguments and flags that specify the backup you want to describe.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+    collection: redis.projects.locations.backupCollections.backups

gcloud auth application-default login/google-cloud-sdk/lib/surface/redis/clusters/backups/export.yaml

@@ -0,0 +1,40 @@
+- release_tracks: [ALPHA, BETA, GA]
+  command_type: GENERIC
+  help_text:
+    brief: |
+      Export a Redis cluster backup to a Google Cloud Storage bucket.
+    description: |
+      This command exports a Redis cluster backup to a Google Cloud Storage bucket.
+      A new folder will be created in the bucket with the backup name. And the backup files will be
+      stored in the folder.
+
+    examples: |
+      To export a backup with name `my-backup` under backup collection `my-collection`
+      in `us-central` region to `my-bucket` Google Cloud Storage bucket, run:
+
+      $ {command} my-backup --backup-collection=my-collection --region=us-central1 --bucket-name=my-bucket
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.redis.resources:backup
+      help_text:
+        Arguments and flags that specify the Redis backup you want to export.
+    params:
+    - arg_name: gcs-bucket
+      api_field: exportBackupRequest.gcsBucket
+      required: true
+      help_text: |
+        The name of the Google Cloud Storage bucket to export the backup to.
+
+  async:
+    collection: redis.projects.locations.operations
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+    collection: redis.projects.locations.backupCollections.backups
+    method: export

gcloud auth application-default login/google-cloud-sdk/lib/surface/redis/clusters/backups/list.yaml

@@ -0,0 +1,40 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  help_text:
+    brief: |
+      List backups under a backup collection in a region.
+    description: |
+      List backups under a backup collection in a region.
+
+      To specify the maximum number of results, use the `--limit` flag.
+    examples: |
+      To list up to 5 backups in the us-central1 region, run:
+
+      $ {command} --backup-collection=my-collection --region=us-central1 --limit=5
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.redis.resources:backup_collection
+      help_text: |
+        The backup collection of the backups to display.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+    collection: redis.projects.locations.backupCollections.backups
+
+  response:
+    id_field: name
+
+  output:
+    format: |
+      table(
+        name.basename():label=BACKUP_NAME,
+        state:label=STATE,
+        createTime:label=CREATE_TIME:sort=1,
+        expireTime:label=EXPIRE_TIME:sort=2
+      )