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

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

@@ -0,0 +1,109 @@
+- release_tracks: [GA, BETA, ALPHA]
+  help_text:
+    brief:  Create a Filestore backup.
+    description: |
+      Create a Filestore backup of an instance file share.
+
+      This command can fail for the following reasons:
+        * A backup with the same name already exists.
+        * The active account does not have permission to create backups.
+    examples: |
+      To create a backup with the name 'my-backup' and description 'My backup description' in a
+      particular region like 'us-central1' from an instance called 'my-instance' in 'us-central1-c'
+      and the source file share called 'my-fs', run:
+
+        $ {command} my-backup --instance=my-instance --file-share=my-fs --instance-zone=us-central1-c --region=us-central1 --description="My backup description"
+
+  arguments:
+    params:
+    - arg_name: backup
+      is_positional: true
+      required: true
+      help_text: |
+        Arguments and flags that specify the Filestore backup you want to
+        create.
+    - arg_name: instance
+      required: true
+      help_text: |
+        Share name of the Filestore instance you want to backup.
+    - arg_name: region
+      required: true
+      help_text: |
+        Region (e.g. us-central1) for the backup.
+    - group:
+        mutex: true
+        required: true
+        params:
+        - arg_name: instance-zone
+          help_text: |
+            Zone of the Filestore instance.
+        - arg_name: instance-location
+          release_tracks: [BETA, GA]
+          help_text: |
+            Region of the Filestore instance.
+    - api_field: backup.description
+      arg_name: description
+      required: false
+      help_text: |
+        Description for the backup. Limit: 2048 characters.
+    - api_field: backup.kmsKeyName
+      arg_name: kms-key
+      required: false
+      release_tracks: [BETA]
+      help_text: |
+        CMEK for backup in the form of `projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}`
+    - api_field: backup.kmsKey
+      arg_name: kms-key
+      required: false
+      release_tracks: [GA]
+      help_text: |
+        CMEK for backup in the form of `projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}`
+    - api_field: backup.sourceFileShare
+      arg_name: file-share
+      required: true
+      help_text: |
+        File share name on the Filestore instance to backup.
+    - api_field: backup.labels.additionalProperties
+      arg_name: labels
+      metavar: KEY=VALUE
+      required: false
+      help_text: |
+        List of label KEY=VALUE pairs to add.
+      type:
+        arg_dict:
+          flatten: true
+          spec:
+          - api_field: key
+          - api_field: value
+    - api_field: backup.tags.additionalProperties
+      arg_name: tags
+      release_tracks: [BETA, GA]
+      required: false
+      metavar: KEY=VALUE
+      help_text: |
+        List of tag KEY=VALUE pairs to add.
+      type:
+        arg_dict:
+          flatten: true
+          spec:
+          - api_field: key
+          - api_field: value
+
+  async:
+    collection: file.projects.locations.operations
+
+  request:
+    ALPHA:
+      api_version: v1p1alpha1
+    BETA:
+      api_version: v1beta1
+    GA:
+      api_version: v1
+    display_resource_type: backup
+    collection: file.projects.locations.backups
+    # Disable validating that a backups resource arg is specified (as we are using the
+    # file.projects.locations.backups collection). This collection is populated manually.
+    disable_resource_check: true
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.filestore.backups.util:FormatBackupCreateRequest
+    - googlecloudsdk.command_lib.filestore.backups.util:AddInstanceNameToRequest