Copies Atlas CLI commands for release tag: atlascli/v1.40.0 (#947)

* Project import generated by Copybara.

GitOrigin-RevId: 4c17545fa6fa598e119209254f2f236e29005d6b

* Apply suggestions from code review

Co-authored-by: kanchana-mongodb <[email protected]>

---------

Co-authored-by: apix-bot[bot] <168195273+apix-bot[bot]@users.noreply.github.com>
Co-authored-by: davidhou17 <[email protected]>
Co-authored-by: kanchana-mongodb <[email protected]>

Author: 3 people

source/command/atlas-alerts-settings-create.txt

@@ -52,7 +52,7 @@ Options
    * - -f, --file
      - string
      - false
-     - Path to the JSON configuration file that defines alert configuration settings. To learn more about alert configuration files for the Atlas CLI, see https://dochub.mongodb.org/core/alert-config-atlas-cli.
+     - Path to the JSON configuration file that defines alert configuration settings. Note: Unsupported fields in the JSON file are ignored. To learn more about alert configuration files for the Atlas CLI, see https://dochub.mongodb.org/core/alert-config-atlas-cli.
    * - -h, --help
      - 
      - false

source/command/atlas-alerts-settings-update.txt

@@ -68,7 +68,7 @@ Options
    * - -f, --file
      - string
      - false
-     - Path to the JSON configuration file that defines alert configuration settings. To learn more about alert configuration files for the Atlas CLI, see https://dochub.mongodb.org/core/alert-config-atlas-cli.
+     - Path to the JSON configuration file that defines alert configuration settings. Note: Unsupported fields in the JSON file are ignored. To learn more about alert configuration files for the Atlas CLI, see https://dochub.mongodb.org/core/alert-config-atlas-cli.
    * - -h, --help
      - 
      - false

source/command/atlas-api-accessTracking-listAccessLogsByClusterName.txt

@@ -14,7 +14,7 @@ atlas api accessTracking listAccessLogsByClusterName
 
 `experimental <https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api/>`_: Returns the access logs of one cluster identified by the cluster's name.
 
-Access logs contain a list of authentication requests made against your cluster. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting API Key must have the Project Monitoring Admin role. This command is invoking the endpoint with OperationID: 'listAccessLogsByClusterName'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByClusterName
+Access logs contain a list of authentication requests made against your cluster. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. This command is invoking the endpoint with OperationID: 'listAccessLogsByClusterName'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByClusterName
 
 Syntax
 ------

source/command/atlas-api-accessTracking-listAccessLogsByHostname.txt

@@ -14,7 +14,7 @@ atlas api accessTracking listAccessLogsByHostname
 
 `experimental <https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api/>`_: Returns the access logs of one cluster identified by the cluster's hostname.
 
-Access logs contain a list of authentication requests made against your clusters. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting API Key must have the Project Monitoring Admin role. This command is invoking the endpoint with OperationID: 'listAccessLogsByHostname'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByHostname
+Access logs contain a list of authentication requests made against your clusters. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. This command is invoking the endpoint with OperationID: 'listAccessLogsByHostname'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByHostname
 
 Syntax
 ------

source/command/atlas-api-atlasSearch-createAtlasSearchDeployment.txt

@@ -73,6 +73,14 @@ Options
      - string
      - false
      - api version to use when calling the api call [options: "2023-01-01", "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30".
+   * - -w, --watch
+     - 
+     - false
+     - Flag that indicates whether to watch the command until it completes its execution or the watch times out.
+   * - --watchTimeout
+     - int
+     - false
+     - Time in seconds until a watch times out. After a watch times out, the CLI no longer watches the command.
 
 Inherited Options
 -----------------

source/command/atlas-api-atlasSearch-deleteAtlasSearchDeployment.txt

@@ -69,6 +69,14 @@ Options
      - string
      - false
      - api version to use when calling the api call [options: "2023-01-01", "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30".
+   * - -w, --watch
+     - 
+     - false
+     - Flag that indicates whether to watch the command until it completes its execution or the watch times out.
+   * - --watchTimeout
+     - int
+     - false
+     - Time in seconds until a watch times out. After a watch times out, the CLI no longer watches the command.
 
 Inherited Options
 -----------------

source/command/atlas-api-atlasSearch-updateAtlasSearchDeployment.txt

@@ -73,6 +73,14 @@ Options
      - string
      - false
      - api version to use when calling the api call [options: "2023-01-01", "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30".
+   * - -w, --watch
+     - 
+     - false
+     - Flag that indicates whether to watch the command until it completes its execution or the watch times out.
+   * - --watchTimeout
+     - int
+     - false
+     - Time in seconds until a watch times out. After a watch times out, the CLI no longer watches the command.
 
 Inherited Options
 -----------------

source/command/atlas-api-cloudBackups-cancelBackupRestoreJob.txt

@@ -14,7 +14,7 @@ atlas api cloudBackups cancelBackupRestoreJob
 
 `experimental <https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api/>`_: Cancels one cloud backup restore job of one cluster from the specified project.
 
-To use this resource, the requesting API Key must have the Project Owner role. This command is invoking the endpoint with OperationID: 'cancelBackupRestoreJob'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelBackupRestoreJob
+To use this resource, the requesting API Key must have the Project Backup Manager role. This command is invoking the endpoint with OperationID: 'cancelBackupRestoreJob'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelBackupRestoreJob
 
 Syntax
 ------

source/command/atlas-api-cloudBackups-createBackupExportJob.txt

@@ -69,6 +69,14 @@ Options
      - string
      - false
      - api version to use when calling the api call [options: "2023-01-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-01-01".
+   * - -w, --watch
+     - 
+     - false
+     - Flag that indicates whether to watch the command until it completes its execution or the watch times out.
+   * - --watchTimeout
+     - int
+     - false
+     - Time in seconds until a watch times out. After a watch times out, the CLI no longer watches the command.
 
 Inherited Options
 -----------------

source/command/atlas-api-cloudBackups-createBackupRestoreJob.txt

@@ -14,7 +14,7 @@ atlas api cloudBackups createBackupRestoreJob
 
 `experimental <https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api/>`_: Restores one snapshot of one cluster from the specified project.
 
-Atlas takes on-demand snapshots immediately and scheduled snapshots at regular intervals. If an on-demand snapshot with a status of queued or inProgress exists, before taking another snapshot, wait until Atlas completes completes processing the previously taken on-demand snapshot. To use this resource, the requesting API Key must have the Project Owner role. This command is invoking the endpoint with OperationID: 'createBackupRestoreJob'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupRestoreJob
+Atlas takes on-demand snapshots immediately and scheduled snapshots at regular intervals. If an on-demand snapshot with a status of queued or inProgress exists, before taking another snapshot, wait until Atlas completes completes processing the previously taken on-demand snapshot. To use this resource, the requesting API Key must have the Project Backup Manager role. This command is invoking the endpoint with OperationID: 'createBackupRestoreJob'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupRestoreJob
 
 Syntax
 ------