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

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

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 Google Inc. 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 Managed Microsoft AD backups."""
+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, base.ReleaseTrack.ALPHA)
+class Backups(base.Group):
+  """Managed Microsoft AD Backups."""
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/active_directory/domains/backups/create.yaml

@@ -0,0 +1,52 @@
+- release_tracks: [GA, ALPHA, BETA]
+
+  help_text:
+    brief: |
+      Create a Managed Microsoft AD domain backup.
+    description: |
+      Create a new Managed Microsoft AD domain backup with the specified name using Google Cloud's
+      Managed Service for Microsoft Active Directory.
+
+      This command can fail for the following reasons:
+        * The specified domain doesn't exist.
+        * The specified domain is being created.
+        * A backup already exists with the same target domain name.
+        * The active account doesn't have permission to access the specified domain.
+        * The active account doesn't have permission to create AD domain backups.
+
+    examples: |
+      To create an AD domain backup named `my-backup` under domain
+      `my-domain.com`, run:
+
+        $ {command} my-backup --domain=my-domain.com --project=my-proj --async
+
+  async:
+    collection: managedidentities.projects.locations.global.operations
+
+  request: &request
+    collection: managedidentities.projects.locations.global.domains.backups
+    method: create
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.active_directory.resources:backup
+      help_text: |
+        Name of the Managed Microsoft AD domain backup you want to create.
+    params:
+    - arg_name: labels
+      api_field: backup.labels.additionalProperties
+      metavar: KEY=VALUE
+      help_text: |
+        List of label KEY=VALUE pairs to add.
+      type:
+        arg_dict:
+          flatten: true
+          spec:
+          - api_field: key
+          - api_field: value

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

@@ -0,0 +1,38 @@
+- release_tracks: [GA, ALPHA, BETA]
+
+  help_text:
+    brief: |
+      Delete a Managed Microsoft AD domain backup.
+    description: |
+      Delete a Managed Microsoft AD domain backup with the specified name using Google Cloud's
+      Managed Service for Microsoft Active Directory.
+
+      This command can fail for the following reasons:
+        * The specified backup doesn't exist.
+        * The active account doesn't have permission to access the specified domain.
+        * The active account doesn't have permission to access the specified AD domain backup.
+
+    examples: |
+      To delete an AD domain backup `my-backup` under domain
+        `projects/my-proj/locations/global/domains/my-domain.com`, run:
+
+        $ {command} projects/my-proj/locations/global/domains/my-domain.com/backups/my-backup \
+          --async
+
+  async:
+    collection: managedidentities.projects.locations.global.operations
+
+  request: &request
+    collection: managedidentities.projects.locations.global.domains.backups
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.active_directory.resources:backup
+      help_text: |
+        Name of the Managed Microsoft AD domain backup you want to delete.

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

@@ -0,0 +1,35 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      Describe a Managed Microsoft AD domain backup.
+    description: |
+      Show metadata for a Managed Microsoft AD domain backup.
+
+      Displays all metadata associated with an Active Directory domain backup when provided with a
+      valid domain backup name.
+
+      This command can fail for the following reasons:
+        * The specified domain backup doesn't exist.
+        * The active account doesn't have permission to access the specified
+          domain.
+    examples: |
+      To display all metadata associated with an AD domain backup with the name
+      `my-backup` under the domain `my-domain` in project `my-project`, run:
+
+        $ {command} projects/my-proj/locations/global/domains/my-domain.com/backups/my-backup
+
+  request: &request
+    collection: managedidentities.projects.locations.global.domains.backups
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.active_directory.resources:backup
+      help_text: |
+        Name of the Managed Microsoft AD domain backup you want to describe.

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

@@ -0,0 +1,47 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      List all Managed Microsoft AD domain backups.
+    description: |
+      List all Managed Microsoft AD domain backups in the specified Managed Microsoft AD domain.
+
+      Displays associated Active Directory domain backups.
+
+      This command can fail for the following reasons:
+        * The active account doesn't have permission to access the specified
+          domain.
+    examples: |
+      To list all AD domain backups in the project `my-project` under domain
+      `my-domain.com`, run:
+
+        $ {command} --project=my-project --domain=my-domain.com --limit=5
+
+  request: &request
+    collection: managedidentities.projects.locations.global.domains.backups
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.active_directory.resources:domain
+      help_text: |
+        Name of the domain for which you want to list all associated Managed Microsoft AD domain backups.
+
+  response:
+    id_field: name
+
+  output:
+    format: |
+      table(
+        name.basename():label=NAME,
+        backup:label=BACKUP,
+        state:label=STATE,
+        type:label=TYPE,
+        description:label=DESCRIPTION,
+        createTime.date()
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/active_directory/domains/backups/update.yaml

@@ -0,0 +1,46 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      Update a Managed Microsoft AD domain backup.
+    description: |
+      Update a Managed Microsoft AD domain backup.
+        * The specified backup doesn't exist.
+        * The active account doesn't have permission to access the specified domain.
+        * The active account doesn't have permission to access the specified domain backup.
+
+    examples: |
+      To update an AD domain backup `my-backup` under domain
+        `projects/my-proj/locations/global/domains/my-domain.com` with the labels `l1` and `l2`, run:
+
+        $ {command} projects/my-proj/locations/global/domains/my-domain.com/backups/my-backup \
+          --update-labels=l1=1,l2=2
+
+  async:
+    collection: managedidentities.projects.locations.global.operations
+
+  request: &request
+    collection: managedidentities.projects.locations.global.domains.backups
+    ALPHA:
+      api_version: v1alpha1
+      modify_request_hooks:
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdatePatchRequest
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdateLabels
+    BETA:
+      api_version: v1beta1
+      modify_request_hooks:
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdatePatchRequest
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdateLabels
+    GA:
+      api_version: v1
+      modify_request_hooks:
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdatePatchRequest
+      - googlecloudsdk.command_lib.active_directory.backup_util:UpdateLabels
+    method: patch
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.active_directory.resources:backup
+      help_text: |
+        Name of the Managed Microsoft AD domain backup you want to update.
+    additional_arguments_hook: googlecloudsdk.command_lib.active_directory.flags:BackupUpdateLabelsFlags